Returns currency metadata with optional exact-symbol filtering and pagination. No authentication required.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns currency symbols, names, icons and reference-asset information. Query a specific symbol or retrieve the currency directory page by page.
Rate limit: 10 requests per 10 seconds per IP.
Access
Public, read-only endpoint. No API key, nonce, signature or account permission is required. The directory is not scoped to a user or Portfolio.
A currency appearing here does not mean it is supported for trading, deposits, withdrawals or transfers. This endpoint does not return balances, supported networks or supported exchanges.
Filtering and pagination
currencyis optional. Omit it to query the full directory. When supplied, it matches the complete symbol, case-insensitively:USDTandusdtreturn the same result. An empty string is invalid; an unknown symbol returns an empty list.- A symbol can identify multiple currencies. For example,
FUNmatches distinct currency IDs. UsecurrencyDetails.idor the uniqueslugto distinguish them; do not assume the symbol is unique or take only the first match. - Results are ordered by currency ID ascending. Pagination also applies when filtering by
currency. - Only
currency,pageandpageSizeare supported.idandslugquery parameters do not filter the results.
| Pagination input | Behavior |
|---|---|
Omit page / pageSize | Use 1 / 20. |
Empty, zero or negative page / pageSize | Use the corresponding default. |
Invalid integer format, such as abc | Return 1000, identifying the invalid field. |
pageSize > 1000 | Return 100400. |
| Page beyond the last result | Return an empty list and retain the matching totalSize. |
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | 200 for success. |
message | string | Result message. |
data.page | integer | Effective page number, starting at 1. |
data.pageSize | integer | Effective page size. |
data.totalSize | integer | Total matching currencies across all pages. |
data.list | array | Currency entries on the selected page. Empty when there are no matches or the page is beyond the last result. |
data.list[].currency | string | Currency symbol. Symbols are not unique. |
data.list[].currencyDetails | object | Currency metadata described below. |
data.list[].updatedAt | integer or null | Currency information update time, in Unix milliseconds. |
Currency details
| Field | Type | Description |
|---|---|---|
id | integer | Currency ID. May be a CMC ID or a platform-defined ID. |
iconUrl | string or null | Currency icon URL. |
currencyName | string or null | Currency display name. |
slug | string | Unique textual currency identifier. |
referenceAssetId | integer or null | Reference asset ID associated with this currency. |
multiplier | integer or null | Conversion multiplier associated with the reference asset. |
Error codes
Check JSON code even when HTTP status is 200. Common errors are described in Error Codes.
| Code | Meaning |
|---|---|
1000 | Invalid integer format for page or pageSize. |
100400 | Invalid parameter value, including an empty currency or pageSize greater than 1000. |
The response panel includes a full example page, an exact-symbol query, a query matching multiple currency IDs, and empty and error responses.
