Api Endpoint

Currency Code Lookup (ISO 4217)

Currency lookup by 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.

Open interactive test console

Offering

Provider
api.duoleads.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.duoleads.com/v1/ref/currency
MIME type
application/json
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
Currency, currency-code, iso-4217, Finance, ref

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39"
  }
]

Observed health

Status
Healthy
Latest latency
28 ms
Average latency
822 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "ISO 4217 alpha-3 or 3-digit numeric code.",
          "maxLength": 16
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2; returns the currencies in use there.",
          "maxLength": 16
        },
        "include": {
          "type": "string",
          "description": "Comma-separated: territories, historic. Default none.",
          "maxLength": 64
        }
      },
      "required": []
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "code": {
              "description": "ISO 4217 alpha-3 or 3-digit numeric code.",
              "maxLength": 16,
              "type": "string"
            },
            "country": {
              "description": "ISO 3166-1 alpha-2; returns the currencies in use there.",
              "maxLength": 16,
              "type": "string"
            },
            "include": {
              "description": "Comma-separated: territories, historic. Default none.",
              "maxLength": 64,
              "type": "string"
            }
          },
          "required": [],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "properties": {
                "cash_minor_units": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "cash_rounding": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "code": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "currencies": {
                  "items": {
                    "properties": {
                      "cash_minor_units": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "cash_rounding": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "code": {
                        "type": "string"
                      },
                      "is_fund": {
                        "type": "boolean"
                      },
                      "minor_units": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "numeric": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "status": {
                        "type": "string"
                      },
                      "territories": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      }
                    },
                    "required": [
                      "code",
                      "numeric",
                      "name",
                      "minor_units",
                      "cash_minor_units",
                      "cash_rounding",
                      "is_fund",
                      "status"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "found": {
                  "type": "boolean"
                },
                "is_fund": {
                  "type": "boolean"
                },
                "minor_units": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "numeric": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "numeric_shared_with": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "status": {
                  "type": "string"
                },
                "territories": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "withdrawn": {
                  "type": "string"
                }
              },
              "required": [
                "found"
              ],
              "type": "object"
            },
            "meta": {
              "properties": {
                "computed_at": {
                  "description": "RFC 3339 UTC with milliseconds",
                  "type": "string"
                },
                "deterministic": {
                  "type": "boolean"
                },
                "disclaimer": {
                  "type": "string"
                },
                "price_usd": {
                  "type": "string"
                },
                "request_id": {
                  "type": "string"
                },
                "sources": {
                  "items": {
                    "required": [
                      "id",
                      "version",
                      "published"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "required": [
                "request_id",
                "computed_at",
                "price_usd",
                "deterministic",
                "disclaimer"
              ],
              "type": "object"
            },
            "ok": {
              "const": true
            },
            "route": {
              "const": "/v1/ref/currency"
            },
            "version": {
              "type": "string"
            }
          },
          "required": [
            "ok",
            "route",
            "version",
            "data",
            "meta"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}