ISO 4217 currency reference (minor units) API

Resolve a 3-letter ISO 4217 code to currency name, symbol, the MINOR-UNIT exponent (decimal places agents get wrong — JPY 0, USD 2, BHD 3), and the countries using it — the value-add for correct money math. Answers 'how many decimals does JPY have', 'symbol for EUR', 'what countries use USD', 'minor units of BHD'.

Price$0.01per request

MethodPOST

Route/v1/ref/currency

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refcurrencyiso-4217minor-unitsdecimalsmoneysymbolfx

API URLhttps://x402.hexl.dev/v1/ref/currency

Integration docs

Example request

{
  "code": "JPY"
}

Example response

{
  "code": "JPY",
  "found": true,
  "name": "Yen",
  "symbol": "¥",
  "minorUnits": 0,
  "countries": [
    "Japan"
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "examples": [
        "USD",
        "JPY",
        "BHD"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}