Double 11 annual ¥1,699/yrView
Global futures · FX

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.

In one sentence

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:

"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)

⇒ 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.

Metals (8)

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

Energy & chemicals (5)

WTI crude fuCL · Brent crude hf_OIL · NYMEX natural gas fuNG · NYMEX gasoline fuRB · NYMEX heating oil fuHO

Base metals (7)

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

Grains & livestock (10)

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

Equity index (11)

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

Rates (7)

10Y Treasury fuZN · 5Y fuZF · 2Y fuZT · 30Y fuZB · Ultra 10Y fuTN · Ultra 30Y fuUB · 30-day Fed Funds fuZQ

Currency futures (7) · contract prices, not FX rates

CME euro fu6E · pound fu6B · Canadian dollar fu6C · Australian dollar fu6A · Mexican peso fu6M · Swiss franc fu6S · NZ dollar fu6N

FX spot (10)

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:

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)

⚠️ 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:

"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

⚠️ 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:

Futures snapshot, 24 columns: bid/ask, settlement and previous close, open interest + daily change, expiry date, 52-week high/low, VWAP, delayed flag
Institutional
FX spot quote, 14 columns: last price, bid/ask, change, open/high/low, previous close, market status
Institutional
Daily / weekly / monthly bars (7 columns futures, 5 FX) · up to 1212 rows
Free
Intraday today / last 5 sessions (price + time only)
Standard+
Latest daily bar (last / OHLC / volume / open interest)
Free

Boundaries up front

These are not "unfinished" — the data simply is not there:

No domestic Chinese commodity futures

Rebar, iron ore, SHFE copper, soybean meal, PTA, INE crude: zero search hits. Use another source for domestic contracts.

No domestic index or Treasury futures

IF / IC / IM / IH and T / TF / TS: zero hits. Global index futures are covered (fuES fuNQ fuYM fuCN).

No quarterly or yearly bars

period=season / year return 422 for futures and FX — only day / week / month.

No start / end

A date range returns 422 for these instruments (the channels disagree on price basis) — use count for the last N bars.

FX has no volume

FX bars are date open last high low only — chart price, but never volume or a volume ratio.

Intraday is price only

/v1/minute returns price + time for futures/FX — no volume, no turnover, no average price line.

No softs or VIX

Sugar, cotton, coffee, cocoa, lumber, OJ and VIX futures: zero hits.

Two bank-quoted codes unavailable

spAU9999 / spPT9995 show up in search but have no quotes, so they are excluded from the whitelist.

FAQ

Is gold spot or futures?

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.

How much history can I get?

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.

Can I run technical indicators on FX?

/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.

Can I build cross-market strategies?

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.

Try one gold bar

Daily / weekly / monthly bars are free; intraday needs Standard+; live snapshots (bid/ask, settlement, expiry) are Institutional.