{"uid":"cap_ZfY7f3P8FjjtmDGowUe_Q","slug":"country-and-currency-codes-iso-4217-currency-info-5937c6a6","name":"Country and Currency Codes — ISO 4217 Currency Info","description":"ISO 4217 currency details by code, number or name: minor units, issuers, countries; optional exact rounding of an amount.","url":"https://country-codes-iso.x402tookit.com/currency-info?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":["q"],"properties":{"q":{"type":"string","description":"Currency code, number or name, e.g. JPY, 978 or Swiss franc"},"amount":{"type":"string","description":"Optional decimal amount to round to the currency's minor unit, e.g. 1.005"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"currency":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"kind":{"type":["null","string"]},"name":{"type":["null","string"]},"issuers":{"type":["array","null"],"items":{"type":"string"}},"numeric":{"type":["null","string"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"alpha2":{"type":["null","string"]}}}},"minorUnit":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"rounding":{"type":["null","object"],"properties":{"input":{"type":["null","string"]},"method":{"type":["null","string"]},"rounded":{"type":["null","string"]},"minorUnit":{"type":["null","number"]}}},"matchedOn":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nAPy_dnY66EXAvzIOESHY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up ISO 4217 currency details (minor units, issuers, countries) by code, number, or name, with optional rounding of an amount to the currency's minor unit.","exampleAgentPrompt":"What are the ISO 4217 details for the Swiss franc — its currency code, numeric code, minor units, and which countries use it? Also, round the amount 1.005 to the correct number of decimal places for that currency.","exampleUseCases":[{"title":"Rounding invoice amounts for KWD","prompt":"I'm generating an invoice in Kuwaiti dinars — can you look up KWD and round the amount 12.3456 to the correct number of minor units for that currency?"},{"title":"Identifying currency for a numeric code","prompt":"I have the ISO 4217 numeric code 978 and need to know the currency name, which countries use it, and how many decimal places it has."},{"title":"Checking which countries use a currency","prompt":"Which countries officially use the currency with the code SEK, and what are its minor units and numeric ISO 4217 code?"}],"resultDescription":"Returns a currency object with the ISO 4217 code, name, numeric code, minor unit count, issuing authorities, and a list of countries (with alpha-2 codes) that use the currency. If an amount is provided, also returns a rounding object showing the input, the rounded value, the minor unit used, and the rounding method applied. Metadata includes source attribution, a summary verdict, and any degraded-data warnings.","failureModes":["Unknown currency code, number, or name returns a non-match result with reasons field populated","Malformed or missing 'q' parameter returns a validation error","Ambiguous name may return a partial or best-guess match with matchedOn field indicating how it was resolved","Amount field with non-numeric value may return an error or be ignored","Service degradation flagged in the 'degraded' boolean field"],"whenToPreferThis":"Use this endpoint when you need authoritative ISO 4217 metadata — minor units, numeric codes, issuers, or country coverage — for a specific currency identified by code, number, or name. It is especially useful when you also need to correctly round a monetary amount to the currency's defined precision (e.g. for invoice generation, payment processing, or display formatting). Prefer it over generic country-to-currency lookups when the currency identifier is already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:42:01.884Z","isFirstParty":false,"canonicalSlug":"country-and-currency-codes-iso-4217-currency-info-5937c6a6"}