API reference
List currencies
Supported fiat quote currencies and amount precision. The catalogue is dynamic.
GET
/currenciesDiscover supported fiat quote currencies, names, display symbols and decimal precision. Active ISO monetary currencies available through CoinMarketCap. Publishable keys may call it; this does not describe fiat payouts or country eligibility. The example response is abbreviated; the endpoint returns the complete catalogue.
- Permission
- read:currencies
- Auth
- api-key
- Idempotent
- No
- Language
- Node.js
const response = await fetch(`${process.env.BOSPAY_API_BASE}/currencies`, {
method: "GET",
headers: {
"Content-Type": "application/json",
"BOSPay-Version": "2026-09-23",
"X-API-Key": process.env.BOSPAY_API_KEY,
}
});
if (!response.ok) {
throw new Error(`BOSPay request failed: ${response.status}`);
}
const data = await response.json();Success
200
{
"object": "list",
"version": "2026-09-23",
"provider": "coinmarketcap",
"defaultCurrency": "ZAR",
"updatedAt": "2026-10-02T10:00:00.000Z",
"isoUpdatedAt": "2026-09-17",
"cached": false,
"data": [
{
"object": "currency",
"code": "EUR",
"name": "Euro",
"symbol": "€",
"decimals": 2,
"providerId": 2790
},
{
"object": "currency",
"code": "JPY",
"name": "Japanese Yen",
"symbol": "¥",
"decimals": 0,
"providerId": 2797
},
{
"object": "currency",
"code": "KWD",
"name": "Kuwaiti Dinar",
"symbol": "د.ك",
"decimals": 3,
"providerId": 3550
},
{
"object": "currency",
"code": "ZAR",
"name": "South African Rand",
"symbol": "R",
"decimals": 2,
"providerId": 2812
}
],
"hasMore": false,
"nextCursor": null
}Validation error
400
{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "A valid fiatAmount is required.",
"field": "fiatAmount",
"requestId": "req_3f0c9a1b2c4d5e6f7a8b9c0d"
}
}