{"uid":"cap_u2jne395KV7kV3cz6Fq-J","slug":"2s-iso-4217-currency-lookup-421e6125","name":"2s ISO 4217 Currency Lookup","description":"Look up an ISO 4217 currency. Pass code (alphabetic like USD, or 3-digit numeric like 840) for the canonical record, or country to find the currency/currencies a country uses. Returns the alphabetic + numeric code, English name, minor unit (decimal places — e.g. JPY 0, USD 2, BHD 3), and the countries using it. Bundled authoritative ISO 4217 data — the currency-code + decimal-places ground truth an LLM gets wrong on less-common currencies.","url":"https://2s.io/api/iso/currency","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":[],"properties":{"code":{"type":"string","description":"ISO 4217 code — alphabetic (USD) or numeric (840)."},"country":{"type":"string","description":"Country name to find its currency."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"code":"USD"}}},"response":{"data":{"found":true,"query":{"code":"USD","country":null},"source":{"url":"https://www.iso.org/iso-4217-currency-codes.html","license":"Public domain (ISO 4217 code list; data via datasets/currency-codes, PDDL)","provider":"ISO 4217 currency codes (bundled; datasets/currency-codes)"},"currencies":[{"code":"USD","name":"US Dollar","numeric":"840","countries":["American Samoa","Bonaire, Sint Eustatius And Saba","British Indian Ocean Territory (The)","Ecuador","El Salvador","Guam","Haiti","Marshall Islands (The)","Micronesia (Federated States Of)","Northern Mariana Islands (The)","Palau","Panama","Puerto Rico","Timor-Leste","Turks And Caicos Islands (The)","United States Minor Outlying Islands (The)","United States Of America (The)","Virgin Islands (British)","Virgin Islands (U.S.)"],"minorUnit":2}]},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"iso.currency","settlement":{"txHash":"0x34dce37058ef1e72d970bd775a12b51a19bc4821dcded4617442527480c01a94","network":"eip155:8453","success":true}}}},"exampleRequest":{"code":"USD"},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Cey5dYJxAfcflTZIq7tPh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up ISO 4217 currency details (code, name, numeric code, minor unit, countries) by alphabetic code, numeric code, or country name.","exampleAgentPrompt":"What are the full ISO 4217 details for USD — including its numeric code, minor unit, and which countries use it?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a `found` boolean, the query echo, data source info, and a `currencies` array containing each matching currency's alphabetic code, full name, numeric code, list of countries, and minor unit (decimal places).","failureModes":["Querying an unrecognized code or country name returns `found: false` with an empty currencies array","Passing both `code` and `country` may produce unexpected precedence behavior","Numeric codes must be passed as strings (e.g. '840' not 840)","Payment failure (402) if USDC balance is insufficient or x402 header is missing"],"whenToPreferThis":"Use this endpoint when you need authoritative ISO 4217 ground-truth data — official currency codes, numeric codes, minor units, and country associations — without managing API keys or subscriptions. Prefer it over scraped or LLM-hallucinated currency data when accuracy is critical for fintech, compliance, or EDI workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:52:04.094Z","isFirstParty":false}