Coverage
Data available for USDCNH
All three datasets below cover the offshore yuan, CNH. The onshore rate, CNY, is a different market with its own rules.
| Data | What it is | Granularity | Delivery | Plan | Details |
|---|---|---|---|---|---|
| Daily history / time series | One row per day: OHLC mid, closing bid and ask, or an official fixing | 1 day | API and CSV/Parquet file | Full history on Free (1-day delay); same-day close on Starter | Product page |
| Intraday OHLC bars | Bars built from bid, ask or mid prices | 1 second to 1 hour | API and file | 1-hour bars on Free; 1-minute on Starter; 1-second and bid/ask on Pro | Product page |
| Tick bid/ask | Every bid and ask update, millisecond timestamps | Each quote | API and file | 1 year on Pro; full history on Business | Product page |
Sample data
Sample data preview
The free ECB file has the onshore yuan (EURCNY), not CNH, so it won't give you offshore prices. Request a sample and we'll send USDCNH bars in the schema below.
Schema
Schema
USDCNH bars have the same fields as any other pair. Prices run to four decimals; a pip is 0.0001 yuan.
| Field | Type | Description |
|---|---|---|
symbol |
string | Pair, e.g. GBPUSD |
interval |
string | 1s, 1m, 5m, 15m, 1h |
timestamp |
string | Bar start time, ISO 8601 UTC |
price_side |
string | mid, bid or ask |
open |
number | First price in the bar |
high |
number | Highest price |
low |
number | Lowest price |
close |
number | Last price |
tick_count |
integer | Price updates in the bar (optional) |
vwap |
number | Tick-weighted average price (optional) |
average_spread |
number | Mean ask minus bid in the bar, for cost modelling (optional) |
API
Get it by API
This early access example requests one day of USDCNH minute bars.
curl (example)
curl -G "https://api.marketdata.co/v1/forex/bars" \
-H "Authorization: Bearer $MARKETDATA_API_KEY" \
--data-urlencode "symbol=USDCNH" \
--data-urlencode "interval=1m" \
--data-urlencode "start=2026-11-18T00:00:00Z" \
--data-urlencode "end=2026-11-19T00:00:00Z"
Python (example)
import os
import requests
import pandas as pd
resp = requests.get( # USDCNH minute bars, around the onshore fixing
"https://api.marketdata.co/v1/forex/bars",
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
params={"symbol": "USDCNH", "interval": "1m",
"start": "2026-11-18T00:00:00Z", "end": "2026-11-19T00:00:00Z"},
timeout=30,
)
resp.raise_for_status()
bars = pd.DataFrame(resp.json()["results"])
bars["timestamp"] = pd.to_datetime(bars["timestamp"], utc=True)
fix = bars[(bars["timestamp"].dt.hour == 1) & (bars["timestamp"].dt.minute.between(10, 30))]
print(fix[["timestamp", "close", "tick_count"]])
The PBOC sets the onshore midpoint at 09:15 Beijing time, 01:15 UTC, and the Python tab looks at CNH in the minutes around it.
Datasets
Get it as a file
USDCNH files are priced per pair:
- Formats: CSV and Parquet
- Daily OHLC history: $19 per pair, all years
- 1-minute mid bars: $29 per pair, full history, bid and ask sides included
- Ticks: $3 per pair per month
To study the CNH to CNY spread, you'll also want onshore data; ask us about it through the custom data form.
Use cases
About US Dollar / Offshore Yuan (for traders)
USDCNH is the price of one US dollar in offshore Chinese yuan. The offshore market, centred in Hong Kong, began in 2010 as part of China's push to use the yuan more widely abroad. CNH trades freely, unlike the onshore yuan (CNY).
Onshore, the People's Bank of China sets a daily midpoint and lets CNY trade only within a band around it, currently 2% either side. CNH has no band, so it moves first when sentiment shifts, and the gap between CNH and CNY is a widely watched stress gauge.
What moves it: the daily PBOC fixing, Chinese growth and trade data, US tariff news and rate differentials with the US. Asian hours carry most of the activity.
Liquidity can be squeezed on purpose. In past episodes, notably January 2016, offshore yuan borrowing rates spiked as authorities tightened funding, which made shorting CNH very costly for a few days. A price backtest won't show that cost unless you add it.
Most CNH backtests are about the spread to the onshore rate or about reactions to the fixing. For both, timestamps matter more than usual: Beijing is UTC+8 with no daylight saving, so the fix is always 01:15 UTC.
Pricing
Pricing
USDCNH sits in the standard forex plans:
| Free $0 | Starter $29/mo | Pro $79/mo | Business $249/mo | |
|---|---|---|---|---|
| Daily OHLC | Full history, 1-day delay | Same-day close, bid/ask closes | As Starter | As Starter, commercial use |
| Intraday bars | 1-hour bars, last 30 days | 1-minute bars, 5 years | 1-second bars, bid and ask sides | As Pro, commercial use |
| Tick bid/ask | No | No | 1 year of history | Full history |
Full plan details are on the pricing page.
FAQ
Frequently asked questions
What's the difference between CNH and CNY?
CNH is the offshore yuan, traded freely mostly in Hong Kong. CNY is the onshore yuan, which the PBOC keeps within a band around a daily midpoint.
Is the ECB yuan rate in the free file the same as USDCNH?
No, the ECB publishes the onshore yuan against the euro (EURCNY). It's a useful reference but not an offshore price.
How far back does USDCNH data go?
The offshore market began in 2010, so no history goes back further. We'll confirm our start dates per resolution before launch.
Can I get USDCNH data as CSV?
Yes, USDCNH comes as CSV or Parquet. CSV opens directly in Excel; keep four decimals when you format the price column.
Is there a free USDCNH sample?
Not yet. Ask through the button above and we'll send a USDCNH extract that includes the 01:15 UTC fixing window.
Keep reading