How to get available currencies
Overview
Use Currency API to get supported fiat and cryptocurrency lists for Calypso integrations.
Use these methods when you need to validate a request currency, build a currency selector, or format crypto amounts correctly.
Integration flow
- Get all supported currency tickers by using [POST] currency.
- If you need fiat metadata, get fiat currencies by using [POST] currency/fiat.
- If you need crypto display metadata, get crypto full info by using [POST] currency/crypto/full-info.
Common request fields
Currency API methods use the standard request wrapper.
| Field | Type | Required | Description |
|---|---|---|---|
| timestamp | number | Yes | Current Unix UTC timestamp in milliseconds. The value must not be less than 3 minutes in the past or greater than 3 minutes in the future. |
Get all currencies
Use [POST] currency.
Response fields
| Field | Type | Description |
|---|---|---|
| fiatCurrencies | array | Supported fiat currency tickers. |
| cryptoCurrencies | array | Supported cryptocurrency tickers. |
Get fiat currencies
Use [POST] currency/fiat.
Response fields
| Field | Type | Description |
|---|---|---|
| result | array | Fiat currency metadata. |
Get crypto full info
Use [POST] currency/crypto/full-info.
Cryptocurrency fields
| Field | Type | Description |
|---|---|---|
| currency | string | Cryptocurrency ticker. |
| baseCurrency | string | Base cryptocurrency ticker. |
| name | string | Cryptocurrency name. |
| token | boolean | Shows whether the cryptocurrency is a token. |
| network | string | Blockchain network. |
| recommendedDisplayScale | number | Recommended number of decimal places for UI display. |
| blockchainScale | number | Number of decimal places used on the blockchain. |
Recommended handling
| Case | Recommendation |
|---|---|
| Building payment or payout forms | Use cryptoCurrencies to validate supported cryptocurrency values. |
| Displaying crypto balances | Use recommendedDisplayScale from crypto full info. |
| Preparing blockchain amounts | Use blockchainScale when converting between human-readable and blockchain units. |
Related docs
| Document | Link |
|---|---|
| Exchange rates | How to get exchange rates |
| Account balances | How to get balances for a specific account |
| Currency API reference | Currency API |