Tokens
Tokens and networks
Understand supported stablecoins, networks, limits and contract metadata.
Tokens are read-only discovery records for enabled chain-and-currency combinations. Use them for display metadata, contract addresses, precision and payment or payout limits. Availability can change by mode, so do not hard-code token contracts or limits in a customer interface.
API Endpoints
- Get Token: Retrieves the details of a specific token by its ID.
- List Tokens: Returns a paginated list of all supported tokens with optional filtering.
API Endpoint Reference
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/tokens/:id | Retrieves the details of a specific token. |
| GET | /api/v1/tokens | Lists all supported tokens with filters. |
Attributes
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the token (e.g., tok_123456789). |
currency | string | Currency code of the token (e.g., USDC). |
chain | string | Blockchain network (e.g., base). |
decimals | number | Number of decimal places for the token. |
name | string | Optional human-readable name of the token (e.g., USD Coin). |
chain_id | number | Optional chain ID (e.g., 8453). |
chain_name | string | Optional full name of the blockchain (e.g., Base). |
currency_logo_url | string | Optional URL to the token's logo. |
chain_logo_url | string | Optional URL to the chain's logo. |
chain_explorer_url | string | Optional URL to the blockchain explorer. |
contract_address | string | Optional smart contract address (e.g., 0x...). |
minimum_payment | string | Minimum payment amount. |
minimum_payout | string | Minimum payout amount. |
maximum_payment | string | Maximum payment amount. |
maximum_payout | string | Maximum payout amount. |
enabled | boolean | Indicates if the token is enabled. |
created_at | string | Creation timestamp. |
updated_at | string | Last update timestamp. |
A token symbol is not globally unique. Always bind a selection to both chain and currency, and
use the returned decimals when converting between decimal and atomic amounts.
Did this page answer your question?
Your feedback helps us improve the integration path.