Application Tokens

Overview

Application tokens power shareable links for withdrawal widgets and account linking. Use the Liquidity API to list existing tokens and create new ones. All requests require a Bearer token obtained via Generate Access Token.

List Application Tokens

GET {{LIQUIDITY_URL}}/v1/ext/application-token
Auth: Bearer {{accessToken}} Returns a paginated list of application tokens for your business.

Response (200)

{
  "data": [
    {
      "url": "https://sandbox.accounts.centryos.xyz/withdraw/sATdEsJ4RyHF1Ju2EAO_5uglFWEwnQ",
      "application": {
        "id": "098d77b4-ea05-43b1-8b28-cb113b4fc213",
        "externalId": null,
        "token": "sATdEsJ4RyHF1Ju2EAO_5uglFWEwnQ",
        "tokenType": "ACCOUNT_WIDGET",
        "createdAt": "2026-02-15T22:58:40.585Z",
        "expiredAt": "2027-02-15T22:58:40.583Z",
        "valid": true,
        "metadata": "{\"currency\":\"USD\",\"tokenType\":\"ACCOUNT_WIDGET\",\"walletId\":\"35673e53-5519-4841-9ac6-50b6d5273b70\",\"extra\":{\"amountLocked\":false,\"useLinkAccountPath\":false}}",
        "feeHidden": false,
        "redirectTo": "",
        "status": "active",
        "business": {
          "id": "9b5e1e96-5796-4648-94d4-62253728291e",
          "slug": "gradientfi",
          "contactEmail": "akanksha@gradientfi.com",
          "contactPhoneNumber": null
        }
      }
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 10,
    "pageCount": 9,
    "total": 85
  },
  "success": true
}

Response Fields

Field	Type	Description
`data`	array	List of application token objects
`data[].url`	string	Shareable URL for the widget
`data[].application.id`	string	Application ID
`data[].application.token`	string	Token used in the URL
`data[].application.tokenType`	string	e.g. `ACCOUNT_WIDGET`
`data[].application.valid`	boolean	Whether the token is currently valid
`data[].application.status`	string	`active` or `inactive`
`meta.page`	number	Current page
`meta.pageSize`	number	Items per page
`meta.total`	number	Total number of tokens

Create Application Token

POST {{LIQUIDITY_URL}}/v1/ext/application-token
Auth: Bearer {{accessToken}} Creates a new application token for a withdrawal or account-linking widget.

Request

curl -X POST "{{LIQUIDITY_URL}}/v1/ext/application-token" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "expiredAt": "{{$randomDateFuture}}",
    "tokenType": "ACCOUNT_WIDGET",
    "currency": "USD",
    "feeHidden": true,
    "redirectTo": "https://example.com/thank-you",
    "extra": {
      "withdrawalSource": "MERCHANT_WALLET",
      "amount": 45,
      "accountOptions": ["card", "bank", "venmo", "paypal"],
      "counterparty": {
        "firstName": "{{$randomFirstName}}",
        "lastName": "{{$randomLastName}}",
        "email": "timii@gradientfi.com"
      }
    }
  }'

Request Body

Field	Type	Description	Required
`expiredAt`	string	Expiration datetime (ISO 8601 format)	Yes
`tokenType`	string	Must be `ACCOUNT_WIDGET`	Yes
`currency`	string	Currency code (e.g., `USD`)	Yes
`feeHidden`	boolean	Hide fees from the user	No
`redirectTo`	string	URL to redirect after completion	No
`extra.withdrawalSource`	string	Must be `MERCHANT_WALLET`	No
`extra.amount`	number	Amount tied to the widget	No
`extra.accountOptions`	array	Allowed methods: `card`, `bank`, `venmo`, `paypal`	No
`extra.counterparty`	object	Counterparty info (firstName, lastName, email)	No

Response (200)

{
  "data": {
    "url": "https://sandbox.accounts.centryos.xyz/sATjgfpPo1QyfoSFJSQHWTr9Gr3cow",
    "application": {
      "id": "d4c26920-7040-4b12-9ff1-5853f5977f20",
      "token": "sATjgfpPo1QyfoSFJSQHWTr9Gr3cow",
      "tokenType": "ACCOUNT_WIDGET",
      "expiredAt": "2024-07-11T06:57:08.000Z",
      "valid": true
    }
  }
}

Response Fields

Field	Type	Description
`data.url`	string	Shareable widget URL
`data.application.id`	string	Application ID
`data.application.token`	string	Token for the URL
`data.application.tokenType`	string	Token type
`data.application.expiredAt`	string	Expiration datetime (ISO 8601)
`data.application.valid`	boolean	Whether the token is valid

Create Payout Link — Withdrawal widget with amount
Create Linked Account Widget — Account-linking only (use useLinkAccountPath: true)

Getting Started

Authentication

Account

Wallets

Transactions

Payin

Payout

Linked Accounts

Webhooks

Application Tokens

Overview

List Application Tokens

Response (200)

Response Fields

Create Application Token

Request

Request Body

Response (200)

Response Fields

​Overview

​List Application Tokens

​Response (200)

​Response Fields

​Create Application Token

​Request

​Request Body

​Response (200)

​Response Fields

​Related

Overview

List Application Tokens

Response (200)

Response Fields

Create Application Token

Request

Request Body

Response (200)

Response Fields

Related