API ReferenceReference Data

Currencies

List all supported currencies with ISO 4217 codes and decimal precision

GET /api/v1/currencies

Returns all active currencies with ISO 4217 codes and decimal precision.

Request

curl https://api.octopuscards.io/api/v1/currencies \
  -H "Authorization: Bearer <token>"

No query parameters.

Response

[
  {
    "id": 1,
    "name": "US Dollar",
    "currency": "USD",
    "precision": 2
  },
  {
    "id": 2,
    "name": "Euro",
    "currency": "EUR",
    "precision": 2
  }
]

Response Fields

KeyTypeDescription
idintegerUnique currency identifier
namestringFull currency name (e.g. US Dollar)
currencystringISO 4217 currency code (3 characters, e.g. USD)
precisionintegerNumber of decimal places (e.g. 2 for USD, 0 for JPY)

Errors

401 Unauthorized - Missing or invalid JWT token.

{
  "error": {
    "name": "UnauthorizedError",
    "code": "UNAUTHORIZED",
    "message": "Authorization header required"
  }
}

On this page