# X402Node Universal Forex Rate API

> X402Node Universal Forex Rate API is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-10).

Returns the live exchange rate for any currency pair, with optional converted amount calculation

## Facts

- Endpoint: GET https://api.x402node.dev/forex/rate?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402node-universal-forex-rate-api-25397545
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NtgjwE6XKfLXK9FulrcMT

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 x402node-universal-forex-rate-api-25397545
```

Example prompt: What's the current exchange rate from USD to CNY, and how much would 750 US dollars be in Chinese yuan?

## When to prefer this

Choose this endpoint when you need a live exchange rate for any arbitrary currency pair — including less common pairs beyond USD/EUR/JPY — and optionally want the converted value for a specific amount in a single call. Unlike sibling endpoints that are hardcoded to specific pairs, this endpoint accepts any base and quote currency codes as parameters, making it the most flexible option for dynamic or user-specified currency conversion needs.

## Known failure modes

- Unsupported or invalid currency code returns an error response
- Missing required base or quote parameter returns a 400-level error
- Rate data temporarily unavailable returns a service error
- Payment of 0.006 USDC not completed results in 402 Payment Required response
- Malformed currency code (e.g. typo) returns no matching rate

## How this service works

Universal forex rate for ANY currency pair. Params: base, quote (e.g. USD, CNY), amount (optional, returns converted value). 任意货币对实时汇率与换算。任意通貨ペア為替レート。Tipo de cambio de cualquier par. 모든 통화쌍 환율. forex rate, exchange rate, currency convert.

## Output

Returns a JSON object with the base currency, quote currency, the currency pair label, the live exchange rate as a number, an optional converted result (if amount was provided), the timestamp of the rate (as_of), and the data source identifier.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "base",
      "quote",
      "amount"
     ],
     "properties": {
      "base": {
       "type": "string",
       "description": "基准货币，如 USD"
      },
      "quote": {
       "type": "string",
       "description": "计价货币，如 CNY"
      },
      "amount": {
       "type": "string",
       "description": "可选，换算金额"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402node-universal-forex-rate-api-25397545/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)