Chinese Yuan (CNY)
The Chinese Yuan is the official currency of China.
Currency Details
| Currency Code | CNY |
| Symbol | ¥ |
| Minor Unit | Fen (1/100), Jiao (1/10) |
| Country | China |
| Central Bank | People's Bank of China |
Official CNY Central Bank Rates
Live rates on this page are mid-market rates. For tax filings, customs valuations, audits, and compliant invoicing you often need the official reference rate published by People's Bank of China (CFETS) instead. AllRatesToday serves People's Bank of China (CFETS) published rates as JSON, with history and a free latest-rates tier.
Popular CNY Conversions
Live CNY Exchange Rates
Coins & Banknotes
🪙 Coins
💵 Banknotes
Frequently Asked Questions
CNY Exchange Rate API
Get live Chinese Yuan (CNY) exchange rates in your app, spreadsheet or backend with one HTTPS request. The AllRatesToday API returns CNY mid-market rates against 160+ currencies as JSON, converts amounts, serves past dates and date ranges, and also returns the official rate published by People's Bank of China (CFETS).
Endpoints for CNY
| What you need | Request |
|---|---|
| Latest CNY/USD rate | GET /api/v1/rates?source=CNY&target=USD |
| CNY against several currencies | GET /api/v1/rates?source=CNY&target=USD,EUR,GBP |
| Convert an amount from CNY | GET /api/v1/rates?source=CNY&target=USD&amount=1000 |
| CNY rate on a past date | GET /api/v1/rates?source=CNY&target=USD&time=2026-06-30 |
| CNY rate history for a date range | GET /api/v1/rates?source=CNY&target=USD&from=2026-01-01&to=2026-06-30 |
| CNY rates as CSV, XML or Excel | GET /api/v1/rates?source=CNY&target=USD,EUR,GBP&format=csv |
| Official People's Bank of China (CFETS) rate | GET /api/v1/central-bank/pboc/latest |
| All ECB reference rates in CNY, no key | GET /api/open/latest/CNY |
Send your key as Authorization: Bearer YOUR_API_KEY.
The open ECB endpoint needs no key; public pages that display the rates carry a visible link to AllRatesToday.
Example request
cURL
curl "https://allratestoday.com/api/v1/rates?source=CNY&target=USD" \
-H "Authorization: Bearer YOUR_API_KEY"JavaScript (npm install @allratestoday/sdk)
import AllRatesToday from '@allratestoday/sdk';
const client = new AllRatesToday('YOUR_API_KEY');
const rate = await client.getRate('CNY', 'USD');
console.log(rate);Python (pip install allratestoday)
from allratestoday import AllRatesToday
client = AllRatesToday(api_key="YOUR_API_KEY")
rate = client.get_rate("CNY", "USD")
print(rate)Example response
[
{
"rate": 0.0000,
"source": "CNY",
"target": "USD",
"time": "2026-11-01T12:00:00Z"
}
]The rate value above is filled in from the live CNY/USD rate when the page loads.
What developers build with CNY rates
- Prices in CNY: show product prices, subscriptions or quotes in Chinese Yuan for visitors in China.
- Checkout and invoicing: convert order totals to or from CNY at the current rate and store the rate used.
- Accounting and reporting: pull daily CNY rates for month-end revaluation, using the official People's Bank of China (CFETS) rate where the rules require it.
- Dashboards and spreadsheets: download CNY history as CSV or Excel, or sync rates into an ERP with the accounting integrations.
- AI agents: give an assistant live CNY rates through the hosted MCP server.
Browse Other Currencies
Packages and open data
- JavaScript: @allratestoday/sdk on npm — live CNY rates, conversion and official central-bank tables.
- Python: allratestoday on PyPI · PHP: allratestoday/sdk on Packagist · Go: allratestoday-go · Rust: allratestoday on crates.io.
- People's Bank of China (CFETS) rates for CNY: pboc-exchange-rate on npm · source on GitHub · docs.
- Open dataset of official central-bank rates, refreshed daily: Hugging Face · Kaggle · GitHub (JSON and CSV).
- AI agents: hosted MCP server, @allratestoday/mcp-server on npm and the OpenClaw skill.
- All code: AllRates-Today on GitHub · SDK docs.