List Tokens

GET /v1/tokens

Overview

Retrieves a paginated list of supported cryptocurrency tokens with optional filtering by offset and limit parameters.

Authorization

• Header: Authorization: Bearer sk_test_907...de66

Request Details

Request

cURL

curl "https://api-prod.paybytoken.io/v1/tokens?offset=0&limit=10" \
  -X GET \
  -H "Authorization: Bearer sk_test_907...de66"

Request Parameters

Parameter	Type	Description
offset	number	Starting point for pagination.
limit	number	Maximum number of tokens to return per page.

Response Details

Response

The response returns a paginated list of Token objects containing details about supported tokens. See Tokens Overview for the full object definition.

Attributes

Attribute	Type	Description
total	integer	Total number of payment intents available.
data	array of objects	List of payment intent objects with their details.

Example Response

Success

{
  "total": 2,
  "data": [
    {
      "id": "tok_ofIgtXhdeH7wWHIW",
      "currency": "USDC",
      "chain": "ethereum",
      "decimals": 6,
      "name": "USD Coin",
      "chain_id": 11155111,
      "chain_name": "Ethereum",
      "currency_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/usdc-logo.png",
      "chain_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/eth-logo.png",
      "chain_explorer_url": "https://sepolia.etherscan.io",
      "contract_address": "0x1C0c0a3843f952DcD9159C9101f8E74844d92fED",
      "minimum_payment": "1.0",
      "minimum_payout": "1.0",
      "maximum_payment": "50000.0",
      "maximum_payout": "1000000.0",
      "enabled": 1,
      "created_at": "2025-09-25T17:13:50.000Z",
      "updated_at": "2025-09-25T17:13:50.000Z"
    },
    {
      "id": "tok_ofIiMC131ysXsbCj",
      "currency": "USDC",
      "chain": "base",
      "decimals": 6,
      "name": "USD Coin",
      "chain_id": 84532,
      "chain_name": "Base",
      "currency_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/usdc-logo.png",
      "chain_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/base-logo.png",
      "chain_explorer_url": "https://sepolia.basescan.org",
      "contract_address": "0xBd02F04420F7bA751d6240f053E2decfb6c90821",
      "minimum_payment": "0.1",
      "minimum_payout": "1.0",
      "maximum_payment": "50000.0",
      "maximum_payout": "1000000.0",
      "enabled": 1,
      "created_at": "2025-09-25T17:13:50.000Z",
      "updated_at": "2025-09-25T17:13:50.000Z"
    }
  ]
}