Currency Codes · Data API

World Currency Codes

Official three-letter codes, numeric codes and decimal places for every currency in the world.

The international reference list of currency codes, showing which countries and territories use each currency, its alphabetic and numeric code, the number of minor units (decimal places), and any withdrawal date for retired currencies. Payment, fintech, e-commerce and accounting teams need it to validate, format and convert monetary amounts correctly.

Get API key View docs

Source: Currency Codes (ISO 4217) — Frictionless Data Core Datasets · ODC PDDL 1.0 · Currency code data from the Frictionless Data core datasets (github.com/datasets/currency-codes), derived from the ISO 4217 maintenance agency list.

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

GET /v1/data/world-currency-codes
GET /v1/data/world-currency-codes/search?q=...
GET /v1/data/world-currency-codes/{key}

Base path /v1/data/world-currency-codes · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

Field	Type	Description
entity	str	Country or territory that uses the currency
currency	str	Currency name
alphabetic_code	str	Three-letter currency code, e.g. AUD
numeric_code	str	Three-digit numeric currency code
minor_unit	str	Number of decimal places used for the currency
withdrawal_date	str	Date the currency was withdrawn, if retired

What you get

Every active and withdrawn currency code

Alphabetic and numeric codes side by side

Decimal places so amounts are formatted and rounded correctly

Country and territory to currency mapping

Search by currency name or country

FAQ

Are retired currencies included?: Yes. Withdrawn currencies are listed with their withdrawal date so historical records can still be read.
Why do some currencies show no decimal places?: Some currencies, such as the Japanese yen, have no minor unit. The minor_unit field tells you how many decimals to use.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day

100 API requests per day
All endpoints included
Community support

Get Started

Pro

$9/month

For production apps and AI agents

10,000 requests/day

10,000 API requests per day
All endpoints included
Priority support
Usage dashboard

Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests

Unlimited API requests
All endpoints included
Priority support
Usage dashboard
Dedicated support channel

Go Enterprise

Getting Started

Start building in minutes

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"