API Reference

/currencies Endpoint

List every supported ISO 4217 currency with its code, numeric, name, and symbol. Public and not metered.

Endpoint

GET https://api.currency-core.com/v1/currencies

This endpoint is public, no API key required, and does not count against your quota or rate limit. Use it to discover the full set of currencies CurrencyCore supports and the ISO 4217 codes used to reference them in /convert and /rates.

Response

Returns an array of { code, numeric, name, symbol } objects, sorted by code:

[
  { "code": "AED", "numeric": "784", "name": "United Arab Emirates Dirham", "symbol": "د.إ" },
  { "code": "EUR", "numeric": "978", "name": "Euro", "symbol": "€" },
  { "code": "INR", "numeric": "356", "name": "Indian Rupee", "symbol": "₹" },
  { "code": "USD", "numeric": "840", "name": "United States Dollar", "symbol": "$" }
]

Field	Type	Description
`code`	string	ISO 4217 alpha code, e.g. `USD`, `INR`. Treat this as the stable identifier.
`numeric`	string	ISO 4217 numeric code, zero-padded, e.g. `840`, `356`.
`name`	string	Human-readable currency name.
`symbol`	string	Currency symbol, e.g. `$`, `₹`. For display only.

Examples

This endpoint is public, no Authorization header needed.

curl https://api.currency-core.com/v1/currencies

const currencies = await fetch("https://api.currency-core.com/v1/currencies").then((r) => r.json());
// [{ code: "AED", numeric: "784", name: "United Arab Emirates Dirham", symbol: "د.إ" }, ...]

import requests

currencies = requests.get("https://api.currency-core.com/v1/currencies").json()
print(currencies[:3])

res, _ := http.Get("https://api.currency-core.com/v1/currencies")
defer res.Body.Close()

var currencies []struct {
	Code    string `json:"code"`
	Numeric string `json:"numeric"`
	Name    string `json:"name"`
	Symbol  string `json:"symbol"`
}
json.NewDecoder(res.Body).Decode(&currencies)
fmt.Println(currencies[0])

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.currency-core.com/v1/currencies"))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$currencies = json_decode(
    file_get_contents("https://api.currency-core.com/v1/currencies"),
    true,
);
print_r(array_slice($currencies, 0, 3));

Notes

The list is served from an edge cache, so it’s fast and cheap to poll.
Treat code as the stable identifier; names and symbols are for display.
The natural-language /ai endpoint uses this list (plus the /countries data) to resolve currency names, symbols, and countries to the right ISO 4217 code.