# 2s ISO 4217 Currency Lookup

> 2s ISO 4217 Currency Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-13).

Looks up ISO 4217 currency details (code, name, numeric code, minor unit, countries) by alphabetic code, numeric code, or country name.

## Facts

- Endpoint: GET https://2s.io/api/iso/currency
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-iso-4217-currency-lookup-421e6125
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u2jne395KV7kV3cz6Fq-J

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-iso-4217-currency-lookup-421e6125
```

Example prompt: What are the full ISO 4217 details for USD — including its numeric code, minor unit, and which countries use it?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "code": "USD"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-iso-4217-currency-lookup-421e6125/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)