Early access is open. Free sample datasets are live now. Download a sample

Historical data ยท Early access

USDCNH Historical Data Download (US Dollar / Offshore Yuan)

US dollar against the offshore Chinese yuan: daily history, intraday bars from 1 second to 1 hour, and tick bid/ask.

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