> Source: https://ashareapi.com/en/futures-forex/  ·  Markdown version for LLMs / AI agents

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](/en/docs/endpoints/kline) (daily, weekly, monthly) and [/v1/minute](/en/docs/endpoints/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)

 "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](/en/docs/endpoints/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](/en/docs/endpoints/minute) | `price` `time` | `price` `time`

| | Live snapshot (dedicated endpoint) | **24 columns** ([/v1/futures](/en/docs/endpoints/futures)): bid/ask, settlement, OI change, expiry, 52-week range | **14 columns** ([/v1/forex](/en/docs/endpoints/forex)): bid/ask, change, market status (last price is `price`)

 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](/en/docs/endpoints/minute)
 `price` `time`
 `price` `time`

 Live snapshot (dedicated endpoint)
 **24 columns** ([/v1/futures](/en/docs/endpoints/futures)): bid/ask, settlement, OI change, expiry, 52-week range
 **14 columns** ([/v1/forex](/en/docs/endpoints/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:
 |
| | 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

 "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:
 |
| | Endpoint | What it gives | Tier

| | [/v1/futures](/en/docs/endpoints/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](/en/docs/endpoints/forex) | **FX spot quote, 14 columns**: last price, bid/ask, change, open/high/low, previous close, market status | Institutional

| | [/v1/kline](/en/docs/endpoints/kline) | Daily / weekly / monthly bars (7 columns futures, 5 FX) · up to 1212 rows | Free

| | [/v1/minute](/en/docs/endpoints/minute) | Intraday today / last 5 sessions (`price` + `time` only) | Standard+

| | [/v1/quote](/en/docs/endpoints/quote) | Latest daily bar (last / OHLC / volume / open interest) | Free

 [/v1/futures](/en/docs/endpoints/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](/en/docs/endpoints/forex)
 **FX spot quote, 14 columns**: last price, bid/ask, change, open/high/low, previous close, market status
 Institutional

 [/v1/kline](/en/docs/endpoints/kline)
 Daily / weekly / monthly bars (7 columns futures, 5 FX) · up to 1212 rows
 Free

 [/v1/minute](/en/docs/endpoints/minute)
 Intraday today / last 5 sessions (`price` + `time` only)
 Standard+

 [/v1/quote](/en/docs/endpoints/quote)
 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](/en/docs/endpoints/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](/en/docs/endpoints/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.

## Go deeper
 Related docs:
 [K-line endpoint (8 columns and instrument boundaries)
 7 columns futures / 5 FX · why start/end is rejected](/en/docs/endpoints/kline)[Intraday endpoint
 price/time only · how it differs from minute bars](/en/docs/endpoints/minute)[All endpoints
 Browse every endpoint by category](/en/endpoints)

 Try one gold bar
 Daily / weekly / monthly bars are free; intraday needs Standard+; **live snapshots (bid/ask, settlement, expiry)** are Institutional.
 [MCP setup](/en/mcp)[See pricing](/en/pricing)
