{"uid":"cap_-aPPXl3USm-jedAZ7Wz8A","slug":"duo-data-utilities-iso-4217-currency-lookup-020ccd57","name":"Duo Data Utilities – ISO 4217 Currency Lookup","description":"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.","url":"https://api.duoleads.com/v1/ref/currency?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"code":{"type":"string","maxLength":16,"description":"ISO 4217 alpha-3 or 3-digit numeric code."},"country":{"type":"string","maxLength":16,"description":"ISO 3166-1 alpha-2; returns the currencies in use there."},"include":{"type":"string","maxLength":64,"description":"Comma-separated: territories, historic. Default none."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["found"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"found":{"type":"boolean"},"status":{"type":"string"},"country":{"type":"string"},"is_fund":{"type":"boolean"},"numeric":{"type":["string","null"]},"withdrawn":{"type":"string"},"currencies":{"type":"array","items":{"type":"object","required":["code","numeric","name","minor_units","cash_minor_units","cash_rounding","is_fund","status"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"is_fund":{"type":"boolean"},"numeric":{"type":["string","null"]},"minor_units":{"type":["integer","null"]},"territories":{"type":"array","items":{"type":"string"}},"cash_rounding":{"type":["number","null"]},"cash_minor_units":{"type":["integer","null"]}}}},"minor_units":{"type":["integer","null"]},"territories":{"type":"array","items":{"type":"string"}},"cash_rounding":{"type":["number","null"]},"cash_minor_units":{"type":["integer","null"]},"numeric_shared_with":{"type":"array","items":{"type":"string"}}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/ref/currency"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"code":"EUR","name":"Euro","found":true,"status":"current","is_fund":false,"numeric":"978","minor_units":2,"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"],"cash_rounding":null,"cash_minor_units":2},"meta":{"sources":[{"id":"iso-4217","licence":"Public data (owner decision 2026-09-29)","version":"SIX list one 2026-09-17, list three 2026-01-01","published":"2026-09-17","attribution":"ISO 4217 currency and funds code lists, published by SIX Group as secretariat of the ISO 4217 Maintenance Agency (public data)"},{"id":"cldr-currency-data","licence":"Unicode-3.0","version":"48.2.2","published":"2026-09-28","attribution":"Unicode CLDR, © Unicode, Inc."}],"price_usd":"0.05","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","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/ref/currency","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qdVPTvNo6q8-viTJJpfM9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up an ISO 4217 currency by alpha or numeric code to retrieve its name, minor unit exponent, cash rounding increment, and the territories that use it.","exampleAgentPrompt":"What are the details for the Euro — its ISO 4217 numeric code, how many decimal places it uses, the cash rounding increment, and which countries use it?","exampleUseCases":[{"title":"Invoice rendering with correct decimal places","prompt":"I'm generating an invoice in Japanese Yen — can you look up JPY and tell me how many decimal places I should use and what the cash rounding increment is?"},{"title":"Identifying currencies used in a country","prompt":"Which currencies are currently in use in Switzerland? Include their minor unit details and cash rounding."},{"title":"Validating a currency code before settlement","prompt":"Before I settle this payment, I need to confirm that KWD is a valid current currency, get its numeric code, and find out how many decimal places it uses for cash amounts."}],"resultDescription":"A JSON object containing the currency's alphabetic code, numeric code, English name, current/historic status, minor unit exponent (decimal places), cash rounding increment (where it differs from the minor unit), cash minor units, whether it is a fund instrument, and an array of ISO 3166-1 alpha-2 territory codes where it circulates. Also includes metadata: request ID, computation timestamp, data source attribution (Unicode CLDR), and a determinism flag.","failureModes":["Unknown or invalid ISO 4217 code — returns a not-found response with found: false","Malformed query parameter (e.g. code longer than 16 chars) — likely 400 Bad Request","No code or country provided — may return an error or empty result","Historic currencies may be returned but flagged with status not equal to 'current'","Payment not settled — 402 Payment Required before data is returned"],"whenToPreferThis":"Use this endpoint when you need authoritative ISO 4217 currency metadata — especially the correct number of decimal places and cash rounding increment — for rendering prices, validating currency codes, or determining which currencies operate in a given territory. It is purely a reference/fact lookup and returns no exchange rates; choose a separate FX endpoint for rate conversion. Prefer this over hardcoded lookup tables when you need up-to-date CLDR-sourced territory data or cash rounding rules (e.g. CHF rounds to 0.05).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:44:37.612Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-iso-4217-currency-lookup-020ccd57"}