Get Currency Information

Returns currency metadata with optional exact-symbol filtering and pagination. No authentication required.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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

  • currency is optional. Omit it to query the full directory. When supplied, it matches the complete symbol, case-insensitively: USDT and usdt return the same result. An empty string is invalid; an unknown symbol returns an empty list.
  • A symbol can identify multiple currencies. For example, FUN matches distinct currency IDs. Use currencyDetails.id or the unique slug to 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, page and pageSize are supported. id and slug query parameters do not filter the results.
Pagination inputBehavior
Omit page / pageSizeUse 1 / 20.
Empty, zero or negative page / pageSizeUse the corresponding default.
Invalid integer format, such as abcReturn 1000, identifying the invalid field.
pageSize > 1000Return 100400.
Page beyond the last resultReturn an empty list and retain the matching totalSize.

Response fields

FieldTypeDescription
codeinteger200 for success.
messagestringResult message.
data.pageintegerEffective page number, starting at 1.
data.pageSizeintegerEffective page size.
data.totalSizeintegerTotal matching currencies across all pages.
data.listarrayCurrency entries on the selected page. Empty when there are no matches or the page is beyond the last result.
data.list[].currencystringCurrency symbol. Symbols are not unique.
data.list[].currencyDetailsobjectCurrency metadata described below.
data.list[].updatedAtinteger or nullCurrency information update time, in Unix milliseconds.

Currency details

FieldTypeDescription
idintegerCurrency ID. May be a CMC ID or a platform-defined ID.
iconUrlstring or nullCurrency icon URL.
currencyNamestring or nullCurrency display name.
slugstringUnique textual currency identifier.
referenceAssetIdinteger or nullReference asset ID associated with this currency.
multiplierinteger or nullConversion multiplier associated with the reference asset.

Error codes

Check JSON code even when HTTP status is 200. Common errors are described in Error Codes.

CodeMeaning
1000Invalid integer format for page or pageSize.
100400Invalid 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.

Query Params
string

Optional exact, case-insensitive symbol filter. Can match multiple IDs. Omit for the full directory. Empty is invalid; unknown symbols return an empty list.

integer
Defaults to 1

One-based page. Omitted, empty, zero or negative uses 1. Invalid integer format returns 1000.

integer
≤ 1000
Defaults to 20

Omitted, empty, zero or negative uses 20. Maximum 1000; greater values return 100400. Invalid integer format returns 1000.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json