# ISO 4217 Currency Code Validator

> ISO 4217 Currency Code Validator is a paid API for AI agents from hcrb.in, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Validates ISO 4217 currency codes offline using deterministic format checks, returning validity, reason, and normalized form

## Facts

- Endpoint: POST https://hcrb.in/v1/tools/iso4217-currency-check/call?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iso-4217-currency-code-validator-7df6ee74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QE1D4IAk4lWt8vUYwl_R0

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 iso-4217-currency-code-validator-7df6ee74 -d '<json body>'
```

Example prompt: Can you check whether 'XBT' is a valid ISO 4217 currency code and tell me why it passes or fails?

## When to prefer this

Choose this endpoint when you need a fast, deterministic, offline validation of ISO 4217 currency codes with no dependency on external databases or ML models. Ideal for payment pipelines, compliance workflows, or data cleaning tasks where you need a signed, auditable result at minimal cost ($0.005 USDC per call after the first 3 free daily calls). Prefer this over regex-only checks when you want the 'scope' metadata to understand exactly what type of validation was applied.

## Known failure modes

- Invalid or unrecognized currency code returns valid:false with a reason explaining the failure
- Malformed input (non-string, wrong length) returns an error response
- Payment failure via x402 if USDC balance is insufficient after the 3 free daily calls
- Network timeout if the endpoint is temporarily unavailable

## How this service works

Offline deterministic checks (no ML, no scraping) for business identifiers and rental due-diligence, paid per call via x402 (gasless EIP-3009 USDC on Base). Checksum-verifiable (IBAN, LEI, VAT, ABA, ISBN, SEDOL…) vs format-only (EIN, IFSC, SWIFT/BIC…) — every response returns a scope field. Non-custodial, signed receipts. First 3 calls/day free.

## Output

A JSON object with a boolean 'valid' field, a human-readable 'reason' string explaining the result, a 'scope' field indicating the type of check performed (format-only vs checksum-verifiable), an optional 'normalized' field with the canonical code form, and an optional 'country' field. All checks are performed offline deterministically with no ML or external scraping.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "currency"
   ],
   "properties": {
    "currency": {
     "type": "string",
     "description": "3-letter ISO 4217 code (e.g. USD, EUR, JPY, CNY, BRL, KES, MXN) or 3-digit numeric code (e.g. 840, 978, 392)."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "valid",
   "reason"
  ],
  "properties": {
   "tool": {
    "type": "string"
   },
   "scope": {
    "type": "string"
   },
   "valid": {
    "type": "boolean"
   },
   "reason": {
    "type": "string"
   },
   "country": {
    "type": "string"
   },
   "normalized": {
    "type": "string"
   }
  }
 },
 "example": {
  "valid": true,
  "reason": "checksum valid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iso-4217-currency-code-validator-7df6ee74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hcrb.in](https://www.zero.xyz/host/hcrb.in/llms.txt)