USD/CNH Historical Data Downloader
A desktop app that downloads US Dollar vs Offshore Chinese Renminbi (USD/CNH) price history on your own machine, written straight to your disk as CSV or JSON. History runs from 2012-01-02 — around 14 years — at every timeframe from raw ticks to monthly candles. A complete USD/CNH 1-minute series is roughly 5.2M rows, about 260 MB as CSV.
Or work out the size first: the file-size calculator takes a range and returns the row count and CSV size.
Windows, macOS, Linux · €9 one-time for the entry licence · get the app
What the app fetches for USD/CNH
| Symbol | USD/CNH |
|---|---|
| Instrument | US Dollar vs Offshore Chinese Renminbi |
| Asset class | Forex Crosses |
| Tick & 1-second data from | 2012-06-27 |
| 1–30 minute candles from | 2012-06-27 |
| Hourly & 4-hour candles from | 2012-06-26 |
| Daily & monthly candles from | 2012-01-02 |
| Timeframes | Tick → 1s → 1m → 5m → 15m → 30m → 1h → 4h → Daily → Monthly |
| Price types | Bid & Ask (with volume) |
| File formats | CSV, JSON (MetaTrader, NinjaTrader, Parquet & SQLite/DuckDB from the Pro licence) |
| Coverage | 2012-01-02 → 2026-11-02 (last completed trading day) |
| Retrieval | Local — your machine connects directly to Dukascopy Bank SA |
| Runs on | Windows, macOS, Linux |
USD/CNH timeframes the app supports
- Tick (every quote)
- 1 second
- 1 minute
- 5 minutes
- 15 minutes
- 30 minutes
- 1 hour
- 4 hours
- Daily
- Monthly
USD/CNH coverage & file size, timeframe by timeframe
Every USD/CNH timeframe shares the same 2012-01-02 start date, but not the same scale — coarser candles stay small while tick and intraday files grow fast. Current through 2026-11-02:
| Timeframe | History from | Approx. rows | Approx. CSV |
|---|---|---|---|
| Tick (every quote) | 2012-06-27 | very large | — |
| 1 second | 2012-06-27 | very large | — |
| 1 minute | 2012-06-27 | ~5.2M | ~260 MB |
| 5 minutes | 2012-06-27 | ~1.0M | ~52 MB |
| 15 minutes | 2012-06-27 | ~347K | ~17 MB |
| 30 minutes | 2012-06-27 | ~174K | ~9 MB |
| 1 hour | 2012-06-26 | ~86,800 | ~4 MB |
| 4 hours | 2012-06-26 | ~21,700 | ~1 MB |
| Daily | 2012-01-02 | ~3,700 | ~187 KB |
| Monthly | 2012-01-02 | ~180 | ~9 KB |
Counts are approximate, derived from forex session hours across the available history. Tick and 1-second runs are queued and resumable rather than fetched in one pass. See the data methodology for how candles are built.
Working with the USD/CNH series
This is the offshore renminbi (CNH), created in 2010 and tradable outside mainland controls — a different market from onshore CNY, and the two can and do diverge under stress. The series' defining event is 11 August 2015, when the PBoC's surprise fixing reform devalued the currency and CNH gapped beyond CNY. The pair is managed: long stretches of engineered calm punctuated by policy-driven repricing, which is the worst possible shape for models that infer risk from recent volatility.
USD/CNH historical data — the offshore yuan, tick to daily
USD/CNH tick and 1-minute data
Ticks and 1-minute candles both start 2012-06-27; the full 1-minute run is 5.2M rows, about 260 MB as CSV. Daily candles start only months earlier, on 2012-01-02, so unlike the dollar majors there is no decades-long daily tail here — the whole history of the offshore market fits in the tick era. The complete daily file is 3,700 rows, about 187 KB as CSV.
CNH is not CNY — and the file shows it on mainland holidays
The onshore yuan (CNY) trades in mainland China's interbank market inside a band around the People's Bank of China's daily central parity, set at ±2% since 17 March 2014. CNH is the same currency traded offshore — Hong Kong, London, Singapore — with no band. The onshore market also closes for mainland public holidays, such as Lunar New Year and the early-October National Day week, while CNH keeps trading. So this file has rows on days when there is no CNY fixing. If you join it against an onshore series or the fixing, expect empty values on those days. Do not forward-fill them: forward-filling turns a real CNH–CNY gap into a fake zero spread.
USD/CNH CSV — what the columns are
Candle files are timestamp,open,high,low,close,volume with UTC timestamps; the volume is the source's own quote volume, not a market-wide traded figure, because offshore yuan has no central exchange. Keep prices as floats and do not round on import. A managed currency's normal daily range is small, so the precision you would drop is a large share of a typical day's move.
Is USD/CNH historical data free?
The app is a free download and the data comes straight from Dukascopy Bank SA to your disk, never through our servers. Every licence, including the €9 entry tier, reaches the whole USD/CNH archive at every timeframe — tiers differ by software features, never by history.
What's inside the USD/CNH file
timestamp,open,high,low,close,volumeOne row per candle, stamped with the bar's opening time; tick files instead carry timestamp,askPrice,bidPrice,askVolume,bidVolume on every quote — ask first. Timestamps are epoch milliseconds in UTC, which pd.to_datetime(df.timestamp, unit="ms", utc=True) or =A2/86400000+DATE(1970,1,1) turns into a date. Worked examples and import steps are in the CSV & JSON format guide.
About US Dollar vs Offshore Chinese Renminbi
US Dollar vs Offshore Chinese Renminbi (USD/CNH) is a spot forex pair with 14 years of retrievable history. It is commonly used for backtesting forex trading strategies and expert advisors (EAs), spread and volatility analysis, training algorithmic and machine-learning models, and charting currency-pair history. Pick any date range from 2012-01-02 onward, choose a timeframe and the bid or ask side, and the app fetches and writes the files locally — no scripting.
Frequently asked questions
- How far back does USD/CNH data go?
- USD/CNH history runs from 2012-01-02 — roughly 14 years — up to the last completed trading day, at every timeframe from raw ticks to monthly candles. Every licence tier reaches all of it.
- How large is a full USD/CNH download?
- The complete USD/CNH 1-minute history is roughly 5.2M rows, about 260 MB as CSV. Daily candles over the same instrument are far smaller — around 3,700 rows, 187 KB. Tick and 1-second runs are larger again and are queued and resumable rather than fetched in one pass. Sizes are approximate; nothing is priced by volume.
- What columns are in the USD/CNH CSV file?
- OHLC files contain a timestamp plus open, high, low and close columns (with volume); tick files contain a timestamp with bid and ask prices. All timestamps are UTC. The files import directly into Excel, Google Sheets, Python (pandas read_csv), R, MetaTrader, NinjaTrader and TradingView.
- Do you sell USD/CNH data?
- No — we sell software. The MarketData Hub client retrieves US Dollar vs Offshore Chinese Renminbi (USD/CNH) on your own machine, under your instruction, directly from the source; we never host, cache or relay it. Your use of the retrieved data is subject to the source's terms.
Guides
- Get the app — Windows, macOS, Linux
- How to download historical forex data
- CSV & JSON format — columns explained
- Tick data vs OHLC candles
- Backtesting with historical data
- Import into MetaTrader
- Load in Python (pandas)
- How far back data goes
- vs HistData
- Import into NinjaTrader
Related Forex Crosses
- AUD/CAD — Australian Dollar vs Canadian Dollar
- AUD/CHF — Australian Dollar vs Swiss Franc
- AUD/JPY — Australian Dollar vs Japanese Yen
- AUD/NZD — Australian Dollar vs New Zealand Dollar
- CAD/CHF — Canadian Dollar vs Swiss Franc
- CAD/JPY — Canadian Dollar vs Japanese Yen
- CHF/JPY — Swiss Franc vs Japanese Yen
- EUR/AUD — Euro vs Australian Dollar
- EUR/CAD — Euro vs Canadian Dollar
- EUR/CHF — Euro vs Swiss Franc
- EUR/DKK — Euro vs Danish Krone
- EUR/GBP — Euro vs Pound Sterling
Preview your USD/CNH download — pick a range, see the exact file →
Sizing it up rather than fetching it? Estimate USD/CNH rows and CSV size for any date range.
The preview runs in the browser; the download runs in the free desktop app, on your machine.