Look up a currency by its ISO 4217 alphabetic or numeric code: the official English nam…
Look up a currency by its ISO 4217 alphabetic or numeric code: the official English name, minor-unit exponent, fund flag, the smallest cash denomination where it differs from the minor unit, the territories that use it, and historic codes on request. Returns…
by api.duoleads.com · discovered, not yet claimed by its owner · updated 2026-10-01
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Look up a currency by its ISO 4217 alphabetic or numeric code: the official English name, minor-unit exponent, fund flag, the smallest cash denomination where it differs from the minor unit, the territories that use it, and historic codes on request. Returns the correct rounding increment for cash amounts, which is what a caller needs to render or settle a price. This route returns currency facts only and never an exchange rate.
Tags: deterministic · no-api-key · ref · finance · currency · bazaar
Call contract
- Method
- GET
- Input
- query parameters
- Output
- json
- Last paid call
- 2026-10-01
{
"code": "EUR",
"include": "territories"
}{
"data": {
"cash_minor_units": 2,
"cash_rounding": null,
"code": "EUR",
"found": true,
"is_fund": false,
"minor_units": 2,
"name": "Euro",
"numeric": "978",
"status": "current",
"territories": [
"AD",
"AT",
"AX",
"BE",
"BG",
"BL",
"CY",
"DE",
"EE",
"ES",
"FI",
"FR",
"GF",
"GP",
"GR",
"HR",
"IE",
"IT",
"LT",
"LU",
"LV",
"MC",
"ME",
"MF",
"MQ",
"MT",
"NL",
"PM",
"PT",
"RE",
"SI",
"SK",
"SM",
"TF",
"VA",
"YT"
]
},
"meta": {
"computed_at": "2026-09-28T12:00:00.000Z",
"deterministic": true,
"disclaimer": "Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms",
"price_usd": "0.05",
"request_id": "01K6B7Q4ZC8H3F2M9WXR5TYN0D",
"sources": [
{
"attribution": "ISO 4217 currency and funds code lists, published by SIX Group as secretariat of the ISO 4217 Maintenance Agency (public data)",
"id": "iso-4217",
"licence": "Public data (owner decision 2026-09-29)",
"published": "2026-09-17",
"version": "SIX list one 2026-09-17, list three 2026-01-01"
},
{
"attribution": "Unicode CLDR, © Unicode, Inc.",
"id": "cldr-currency-data",
"licence": "Unicode-3.0",
"published": "2026-09-28",
"version": "48.2.2"
}
]
},
"ok": true,
"route": "/v1/ref/currency",
"version": "1.0.0"
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/36303.jsonfor the price and payment options. - Pay. Call
GET https://api.duoleads.com/v1/ref/currency. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.05 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base
- Demand
- 2 calls · 1 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.05 | 0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39 | 120s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"amountUsd": 0.05,
"maxTimeoutSeconds": 120
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"data": {
"properties": {
"cash_minor_units": {
"type": [
"integer",
"null"
]
},
"cash_rounding": {
"type": [
"number",
"null"
]
},
"code": {
"type": "string"
},
"country": {
"type": "string"
},
"currencies": {
"items": {
"properties": {
"cash_minor_units": {
"type": [
"integer",
"null"
]
},
"cash_rounding": {
"type": [
"number",
"null"
]
},
"code": {
"type": "string"
},
"is_fund": {
"type": "boolean"
},
"minor_units": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"numeric": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"territories": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"code",
"numeric",
"name",
"minor_units",
"cash_minor_units",
"cash_rounding",
"is_fund",
"status"
],
"type": "object"
},
"type": "array"
},
"found": {
"type": "boolean"
},
"is_fund": {
"type": "boolean"
},
"minor_units": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"numeric": {
"type": [
"string",
"null"
]
},
"numeric_shared_with": {
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"type": "string"
},
"territories": {
"items": {
"type": "string"
},
"type": "array"
},
"withdrawn": {
"type": "string"
}
},
"required": [
"found"
],
"type": "object"
},
"meta": {
"properties": {
"computed_at": {
"description": "RFC 3339 UTC with milliseconds",
"type": "string"
},
"deterministic": {
"type": "boolean"
},
"disclaimer": {
"type": "string"
},
"price_usd": {
"type": "string"
},
"request_id": {
"type": "string"
},
"sources": {
"items": {
"required": [
"id",
"version",
"published"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"request_id",
"computed_at",
"price_usd",
"deterministic",
"disclaimer"
],
"type": "object"
},
"ok": {
"const": true
},
"route": {
"const": "/v1/ref/currency"
},
"version": {
"type": "string"
}
},
"required": [
"ok",
"route",
"version",
"data",
"meta"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"data": {
"cash_minor_units": 0,
"cash_rounding": 0,
"code": "string",
"country": "string",
"currencies": [
{
"cash_minor_units": 0,
"cash_rounding": 0,
"code": "string",
"is_fund": true,
"minor_units": 0,
"name": "string",
"numeric": "string",
"status": "string",
"territories": [
"string"
]
}
],
"found": true,
"is_fund": true,
"minor_units": 0,
"name": "string",
"numeric": "string",
"numeric_shared_with": [
"string"
],
"status": "string",
"territories": [
"string"
],
"withdrawn": "string"
},
"meta": {
"computed_at": "string",
"deterministic": true,
"disclaimer": "string",
"price_usd": "string",
"request_id": "string",
"sources": [
{}
]
},
"ok": null,
"route": null,
"version": "string"
},
"type": "string"
}Examples
curl "https://api.duoleads.com/v1/ref/currency"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://api.duoleads.com/v1/ref/currency");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://api.duoleads.com/v1/ref/currency")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- api.duoleads.com
- Endpoint
- https://api.duoleads.com/v1/ref/currency
- Machine-readable
/resources/36303.json