Global futures and FX: gold, crude, Treasuries, currencies — one API
Cross-market research usually gets stuck on the same question first: where do I get gold and the dollar index. We wired that part up: 55 futures across 7 groups + 10 FX spot pairs, daily / weekly / monthly bars, with open interest on futures.
55 global futures across 7 groups (metals / energy & chemicals / base metals / grains / equity index / rates / currency futures) + 10 FX spot pairs, via /v1/kline (daily, weekly, monthly) and /v1/minute (intraday price). Domestic Chinese commodity futures are not covered (rebar, iron ore, SHFE copper, soybean meal, PTA, INE crude), nor are domestic index or Treasury futures.
Four capabilities, four entry points
Pick the entry point by the question you are answering:
| Your question | Entry point | What you get |
|---|---|---|
| "Where is gold / how is it trending?" | /v1/kline?code=fuGC | COMEX gold daily: date open last high low volume openInterest — 7 columns (measured 2026-11-10: 4132.9 · OI 247,993) |
| "Crude / copper / Treasuries / index futures" | /v1/kline?code=fuCL · fuHG · fuZN · fuES | Same fields, different code: WTI crude / COMEX copper / 10Y Treasury / S&P 500 futures |
| "EURUSD, GBPUSD rate?" | /v1/kline?code=fxEURUSD | FX spot 5 columns of OHLC (measured EURUSD 1.1223 · GBPUSD 1.3444) — no volume for FX |
| "Intraday minute prices" | /v1/minute?code=fuGC | Intraday is price + time only (no volume, no turnover) |
/v1/kline?code=fuGCdate open last high low volume openInterest — 7 columns (measured 2026-11-10: 4132.9 · OI 247,993)/v1/kline?code=fuCL · fuHG · fuZN · fuES/v1/kline?code=fxEURUSD/v1/minute?code=fuGCprice + time only (no volume, no turnover)⇒ Code prefixes: fu for futures (fuGC) / fx for FX (fxEURUSD) / r_hd* for HK index futures (r_hdHSImain). One key, shared quota with everything else.
The whitelist (55 global futures + 10 FX spot pairs)
Every code below was verified live one by one — codes outside this list return nothing. Search hits are not proof: the bank-quoted spAU9999 / spPT9995 appear in search but have no quotes, so they are excluded.
COMEX gold fuGC · COMEX silver fuSI · NYMEX platinum fuPL · NYMEX palladium fuPA · COMEX micro gold fuMGC · London gold spot hf_XAU · London silver spot hf_XAG · London platinum spot hf_XPT
WTI crude fuCL · Brent crude hf_OIL · NYMEX natural gas fuNG · NYMEX gasoline fuRB · NYMEX heating oil fuHO
COMEX copper fuHG · LME copper hf_CAD · LME aluminium hf_AHD · LME nickel hf_NID · LME zinc hf_ZSD · LME lead hf_PBD · LME tin hf_SND
CBOT corn fuZC · soybeans fuZS · soybean oil fuZL · soybean meal fuZM · wheat fuZW · rough rice fuZR · oats fuZO · CME live cattle fuLE · lean hogs fuHE · feeder cattle fuGF
FTSE A50 fuCN · S&P 500 fuES · Nasdaq 100 fuNQ · Dow fuYM · Russell 2000 fuRTY · Nikkei fuNIY · USD Nikkei fuNKD · HSI r_hdHSImain · Mini HSI r_hdMHImain · Hang Seng Tech r_hdHTImain · Hang Seng China Enterprises r_hdHHImain
10Y Treasury fuZN · 5Y fuZF · 2Y fuZT · 30Y fuZB · Ultra 10Y fuTN · Ultra 30Y fuUB · 30-day Fed Funds fuZQ
CME euro fu6E · pound fu6B · Canadian dollar fu6C · Australian dollar fu6A · Mexican peso fu6M · Swiss franc fu6S · NZ dollar fu6N
USDCNY fxUSDCNY · offshore CNY fxCNH · EURCNY fxEURCNY · HKDCNY fxHKDCNY · CNYJPY fxCNYJPY · dollar index fxDINIW · EURUSD fxEURUSD · USDJPY fxUSDJPY · GBPUSD fxGBPUSD · USDHKD fxUSDHKD
🔴 fu6* are CME currency futures contracts (they carry basis and an expiry date), not spot rates — never present them as an "AUD rate" for accounting. Spot rates only come from the 10 fx* pairs.
Fields: 7 columns for futures, 5 for FX
Same /v1/kline, but the column count differs by instrument — branch on the instrument, never hard-code columns:
Futures fuGC | FX fxEURUSD | |
|---|---|---|
| Columns | 7 | 5 |
| Fields | date open last high low volume openInterest | date open last high low |
| Volume / open interest | Both present (volume · openInterest) | 🔴 Neither |
amount / turnover | 🔴 Neither (A-share only) | 🔴 Neither |
| Intraday /v1/minute | price time | price time |
| Live snapshot (dedicated endpoint) | 24 columns (/v1/futures): bid/ask, settlement, OI change, expiry, 52-week range | 14 columns (/v1/forex): bid/ask, change, market status (last price is price) |
date open last high low volume openInterestdate open last high lowvolume · openInterest)amount / turnoverprice)⚠️ The close field is last (not close); rows are newest-first, so data[0] is the latest. ⚠️ Futures and FX have no adjustment concept — fq does nothing for them.
Three examples you can run now
Daily / weekly / monthly bars are available on the free tier; intraday needs Standard+.
# 1) Gold: COMEX gold futures, daily, with open interest
curl "https://api.ashareapi.com/v1/kline?code=fuGC&period=day&count=30&key=$KEY"
# 2) FX: EURUSD daily (OHLC only, no volume)
curl "https://api.ashareapi.com/v1/kline?code=fxEURUSD&period=day&count=30&key=$KEY"
# 3) Intraday crude: price only, no volume
curl "https://api.ashareapi.com/v1/minute?code=fuCL&days=1&key=$KEY"
# 4) Gold live snapshot: bid/ask, settlement, OI change, expiry (Institutional)
curl "https://api.ashareapi.com/v1/futures?code=fuGC&key=$KEY"
# 5) EURUSD live quote (Institutional)
curl "https://api.ashareapi.com/v1/forex?code=fxEURUSD&key=$KEY"⚠️ Futures / FX do not accept start / end — passing them returns 422 ("date range not supported, use count"), not a silent downgrade; period=season / year also return 422 (day / week / month only).
An agent can work from this page alone
Once wired as MCP tools, an agent can answer these directly:
| User asks | Agent calls | Note |
|---|---|---|
| "What is gold trading at" | ashare_kline(code="fuGC", period="day", count=1) | Read data[0].last; openInterest for positioning |
| "Crude / copper / Treasury trend" | ashare_kline(code="fuCL" / "fuHG" / "fuZN") | Same fields, different code |
| "EURUSD / USDCNY rate" | ashare_kline(code="fxEURUSD" / "fxUSDCNY") | Only 5 columns — never chart volume |
| "How did gold move intraday" | ashare_minute(code="fuGC") | price / time only — never claim volume |
| "Gold bid/ask / when does this contract expire" | /v1/futures?code=fuGC (REST) | 24-column snapshot: askPrice/bidPrice, expiryDate, dailyOIChange |
| "Rebar / SHFE copper / IF index futures" | Not available — say so | No domestic futures at all; never substitute a same-named global contract |
ashare_kline(code="fuGC", period="day", count=1)data[0].last; openInterest for positioningashare_kline(code="fuCL" / "fuHG" / "fuZN")ashare_kline(code="fxEURUSD" / "fxUSDCNY")ashare_minute(code="fuGC")price / time only — never claim volume/v1/futures?code=fuGC (REST)askPrice/bidPrice, expiryDate, dailyOIChange⚠️ Three rules for agents: (1) futures/FX have no season / year and ignore start/end — use count; (2) FX has no volume, so no "volume surge" claims; (3) fu6* are contract prices, never call them exchange rates.
Every endpoint involved (five)
Two dedicated snapshot endpoints plus three general ones:
| Endpoint | What it gives | Tier |
|---|---|---|
| /v1/futures | Futures snapshot, 24 columns: bid/ask, settlement and previous close, open interest + daily change, expiry date, 52-week high/low, VWAP, delayed flag | Institutional |
| /v1/forex | FX spot quote, 14 columns: last price, bid/ask, change, open/high/low, previous close, market status | Institutional |
| /v1/kline | Daily / weekly / monthly bars (7 columns futures, 5 FX) · up to 1212 rows | Free |
| /v1/minute | Intraday today / last 5 sessions (price + time only) | Standard+ |
| /v1/quote | Latest daily bar (last / OHLC / volume / open interest) | Free |
Boundaries up front
These are not "unfinished" — the data simply is not there:
Rebar, iron ore, SHFE copper, soybean meal, PTA, INE crude: zero search hits. Use another source for domestic contracts.
IF / IC / IM / IH and T / TF / TS: zero hits. Global index futures are covered (fuES fuNQ fuYM fuCN).
period=season / year return 422 for futures and FX — only day / week / month.
start / endA date range returns 422 for these instruments (the channels disagree on price basis) — use count for the last N bars.
FX bars are date open last high low only — chart price, but never volume or a volume ratio.
/v1/minute returns price + time for futures/FX — no volume, no turnover, no average price line.
Sugar, cotton, coffee, cocoa, lumber, OJ and VIX futures: zero hits.
spAU9999 / spPT9995 show up in search but have no quotes, so they are excluded from the whitelist.
FAQ
Both: COMEX gold futures fuGC (open interest, expiry) and London gold spot hf_XAU (bank-quoted). Use fuGC for trend work, hf_XAU for a spot price.
Up to 1212 rows via count — roughly 5 years of daily bars, longer on weekly/monthly. There is no "from date A to date B" mode.
/v1/technical currently covers A-shares and ETFs; for futures/FX compute from the K-lines yourself, or work with the OHLC shape.
fu6E vs fxEURUSD?fu6E is a CME euro futures contract (basis, expiry, premium/discount baked in); fxEURUSD is the spot rate. For settlement or accounting, only the latter is usable.
The data is there: A-shares + Hong Kong + US + ETFs + global futures + FX spot, one key, one naming scheme. The strategy is yours to write — we provide data and validation.
Daily / weekly / monthly bars are free; intraday needs Standard+; live snapshots (bid/ask, settlement, expiry) are Institutional.