# USD to CNY Real-Time Forex Rate

> USD to CNY Real-Time Forex Rate is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns the current real-time exchange rate for the USD/CNY currency pair (US Dollar to Chinese Yuan Renminbi) with no parameters required.

## Facts

- Endpoint: GET https://api.x402node.dev/forex/rate/usd/cny/usd-cny
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usd-to-cny-real-time-forex-rate-c9ae8e64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nQNKum4-Q3r2Za-0VujsL

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 usd-to-cny-real-time-forex-rate-c9ae8e64
```

Example prompt: What's the current USD to CNY exchange rate? I need the live dollar-to-yuan rate right now.

## When to prefer this

Use this endpoint when you need a zero-parameter, real-time USD/CNY spot rate with a clean JSON response. Ideal for quick currency conversion calculations or displaying the current dollar-yuan rate without any authentication or complex query setup.

## Known failure modes

- Rate feed temporarily unavailable — upstream forex data source may be down
- Network timeout if the external rate provider is slow to respond
- Stale rate if the feed has not refreshed recently

## How this service works

Live USD to CNY exchange rate (US Dollar / Chinese Yuan). Zero-param: GET returns current rate. 美元兑人民币实时汇率。米ドル/人民元 為替レート。Tipo de cambio dólar-yuan. 달러 위안 환율. usd cny, usd-cny, USD/CNY forex quote. Accepts payment on Base or Solana — either network works.

## Output

Returns a JSON object containing the currency pair (e.g. 'usd-cny'), base currency ('usd'), quote currency ('cny'), the current numeric exchange rate, the date of the rate, and the data source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usd-to-cny-real-time-forex-rate-c9ae8e64/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)