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

外盘期货 · 外汇

# 外盘期货与外汇：黄金、原油、美债、汇率，一套接口
 做跨市场研究，最先卡住的往往不是策略，而是黄金和美元指数去哪儿取。我们把这部分接上了：外盘期货 7 类 55 个品种 + 10 个外汇现货，日 / 周 / 月 K 线，期货还带持仓量。

 一句话说清
 **外盘期货 7 类 55 个品种（贵金属 / 能源化工 / 基本金属 / 农产品 / 股指 / 利率 / 外汇期货）+ 10 个外汇现货**，走 [/v1/kline](/docs/endpoints/kline)（日/周/月）与 [/v1/minute](/docs/endpoints/minute)（分时价格）。**没有内盘商品期货**（螺纹 / 铁矿 / 沪铜 / 豆粕 / PTA / SC 原油），也没有国内股指期货与国债期货。

## 四类能力，对应四个入口
 按你要回答的问题选入口：
 |
| | 你要回答的问题 | 入口 | 拿到什么

| | 「黄金现在多少 / 走势怎么样？」 | `/v1/kline?code=fuGC` | COMEX 黄金日线：`date open last high low volume openInterest` 7 列（实测 2026-11-10 收 4132.9 · 持仓 247,993）

| | 「原油 / 铜 / 美债 / 美股指数期货」 | `/v1/kline?code=fuCL` · `fuHG` · `fuZN` · `fuES` | 同一套字段，换代码即可：WTI 原油 / COMEX 铜 / 10 年美债 / 标普500 期货

| | 「欧元美元、英镑美元多少？」 | `/v1/kline?code=fxEURUSD` | 外汇现货 OHLC **5 列**（实测 EURUSD 1.1223 · GBPUSD 1.3444）—— ⚠️ 外汇没有成交量

| | 「盘中每分钟价格」 | `/v1/minute?code=fuGC` | 分时 **只有 price + time 两列**（没有成交量 / 成交额）

 「黄金现在多少 / 走势怎么样？」
 `/v1/kline?code=fuGC`
 COMEX 黄金日线：`date open last high low volume openInterest` 7 列（实测 2026-11-10 收 4132.9 · 持仓 247,993）

 「原油 / 铜 / 美债 / 美股指数期货」
 `/v1/kline?code=fuCL` · `fuHG` · `fuZN` · `fuES`
 同一套字段，换代码即可：WTI 原油 / COMEX 铜 / 10 年美债 / 标普500 期货

 「欧元美元、英镑美元多少？」
 `/v1/kline?code=fxEURUSD`
 外汇现货 OHLC **5 列**（实测 EURUSD 1.1223 · GBPUSD 1.3444）—— ⚠️ 外汇没有成交量

 「盘中每分钟价格」
 `/v1/minute?code=fuGC`
 分时 **只有 price + time 两列**（没有成交量 / 成交额）

 ⇒ 代码规则：**期货前缀 fu**（`fuGC`）/ **外汇前缀 fx**（`fxEURUSD`）/ **香港指数期货 r_hd***（`r_hdHSImain`）。同一个 Key，跟其他代码共用额度。

## 品种白名单（55 个外盘期货 + 10 个外汇现货）
 逐个 `quote` 验活过的清单，⛔ 不在清单里的代码取不到数。搜得到不等于取得到 —— 银行间 `spAU9999` / `spPT9995` 能搜到但无行情，已剔除。
 贵金属（8）
 COMEX 黄金 `fuGC` · COMEX 白银 `fuSI` · NYMEX 铂金 `fuPL` · NYMEX 钯金 `fuPA` · COMEX 微型黄金 `fuMGC` · 伦敦金现货 `hf_XAU` · 伦敦银现货 `hf_XAG` · 伦敦铂金现货 `hf_XPT`

 能源化工（5）
 WTI 原油 `fuCL` · 布伦特原油 `hf_OIL` · NYMEX 天然气 `fuNG` · NYMEX 汽油 `fuRB` · NYMEX 燃油 `fuHO`

 基本金属（7）
 COMEX 铜 `fuHG` · LME 铜 `hf_CAD` · LME 铝 `hf_AHD` · LME 镍 `hf_NID` · LME 锌 `hf_ZSD` · LME 铅 `hf_PBD` · LME 锡 `hf_SND`

 农产品（10）
 CBOT 玉米 `fuZC` · 大豆 `fuZS` · 豆油 `fuZL` · 豆粕 `fuZM` · 小麦 `fuZW` · 稻谷 `fuZR` · 燕麦 `fuZO` · CME 活牛 `fuLE` · 瘦肉猪 `fuHE` · 育肥牛 `fuGF`

 股指（11）
 富时A50 `fuCN` · 标普500 `fuES` · 纳指100 `fuNQ` · 道指 `fuYM` · 罗素2000 `fuRTY` · 日经 `fuNIY` · 美元日经 `fuNKD` · 恒指 `r_hdHSImain` · 小恒指 `r_hdMHImain` · 恒生科技 `r_hdHTImain` · 恒生国企 `r_hdHHImain`

 利率（7）
 10年美债 `fuZN` · 5年美债 `fuZF` · 2年美债 `fuZT` · 30年美债 `fuZB` · 超10年美债 `fuTN` · 超30年美债 `fuUB` · 30天联邦基金 `fuZQ`

 外汇期货（7）· 是期货价不是汇率
 CME 欧元 `fu6E` · 英镑 `fu6B` · 加元 `fu6C` · 澳元 `fu6A` · 墨西哥比索 `fu6M` · 瑞郎 `fu6S` · 纽元 `fu6N`

 外汇现货（10）
 美元人民币 `fxUSDCNY` · 离岸人民币 `fxCNH` · 欧元人民币 `fxEURCNY` · 港币人民币 `fxHKDCNY` · 人民币日元 `fxCNYJPY` · 美元指数 `fxDINIW` · 欧元美元 `fxEURUSD` · 美元日元 `fxUSDJPY` · 英镑美元 `fxGBPUSD` · 美元港币 `fxUSDHKD`

 🔴 **fu6* 是 CME 外汇期货合约**（含基差、有到期日），不是即期汇率 ⇒ ⛔ 别拿去当"澳元汇率"做账。要即期汇率只能用 `fx*` 那 10 个。

## 字段：期货 7 列、外汇 5 列，不一样
 同一个 [/v1/kline](/docs/endpoints/kline)，两类标的返回的列数不同 —— 按标的判断，别硬编码列数：
 |
| | | 期货 `fuGC` | 外汇 `fxEURUSD`

| | K 线列数 | **7 列** | **5 列**

| | 字段 | `date open last high low volume openInterest` | `date open last high low`

| | 成交量 / 持仓量 | 两者都有（`volume` · `openInterest`） | 🔴 **都没有**

| | 成交额 `amount` / 换手 `turnover` | 🔴 **都没有**（这两列只属 A 股） | 🔴 **都没有**

| | 分时 [/v1/minute](/docs/endpoints/minute) | `price` `time` 两列 | `price` `time` 两列

| | 实时快照（专用端点） | **24 列**（[/v1/futures](/docs/endpoints/futures)）：买卖价 / 结算价 / 持仓变化 / 到期日 / 52 周高低 | **14 列**（[/v1/forex](/docs/endpoints/forex)）：买卖价 / 涨跌幅 / 市场状态（最新价字段叫 `price`）

 K 线列数
 **7 列**
 **5 列**

 字段
 `date open last high low volume openInterest`
 `date open last high low`

 成交量 / 持仓量
 两者都有（`volume` · `openInterest`）
 🔴 **都没有**

 成交额 `amount` / 换手 `turnover`
 🔴 **都没有**（这两列只属 A 股）
 🔴 **都没有**

 分时 [/v1/minute](/docs/endpoints/minute)
 `price` `time` 两列
 `price` `time` 两列

 实时快照（专用端点）
 **24 列**（[/v1/futures](/docs/endpoints/futures)）：买卖价 / 结算价 / 持仓变化 / 到期日 / 52 周高低
 **14 列**（[/v1/forex](/docs/endpoints/forex)）：买卖价 / 涨跌幅 / 市场状态（最新价字段叫 `price`）

 ⚠️ 收盘价字段名是 `last`（不是 `close`）；返回按日期降序，最新一条在 `data[0]`。⚠️ 期货 / 外汇**没有复权概念**，`fq` 参数对它们无效。

## 三条能直接跑的例子
 日 / 周 / 月 K 线随免费档提供；分时属标准版起。
 ```
# ① 黄金：COMEX 黄金期货日线（带持仓量）
curl "https://api.ashareapi.com/v1/kline?code=fuGC&period=day&count=30&key=$KEY"

# ② 外汇：欧元美元的日线（只有 OHLC，没有量）
curl "https://api.ashareapi.com/v1/kline?code=fxEURUSD&period=day&count=30&key=$KEY"

# ③ 盘中原油：分时（只有价格，没有成交量）
curl "https://api.ashareapi.com/v1/minute?code=fuCL&days=1&key=$KEY"

# ④ 黄金实时快照：买卖价 / 结算价 / 持仓变化 / 到期日（机构版）
curl "https://api.ashareapi.com/v1/futures?code=fuGC&key=$KEY"

# ⑤ 欧元美元实时报价（机构版）
curl "https://api.ashareapi.com/v1/forex?code=fxEURUSD&key=$KEY"
```
 ⚠️ 期货 / 外汇**不吃 start / end** —— 传了会直接 422（"暂不支持日期范围，请用 count 取最近 N 条"），不会静默降级；`period=season` / `year` 同样 422（只有 day / week / month）。

## Agent 拿这一页就能用
 接成 MCP 工具后，Agent 可以直接答这些问题：
 |
| | 用户这么问 | Agent 该调 | 要点

| | 「黄金现在多少钱」 | `ashare_kline(code="fuGC", period="day", count=1)` | 取 `data[0].last`；顺便 `openInterest` 看持仓

| | 「原油 / 铜 / 美债走势」 | `ashare_kline(code="fuCL" / "fuHG" / "fuZN")` | 同一字段，换代码

| | 「欧元美元 / 美元人民币汇率」 | `ashare_kline(code="fxEURUSD" / "fxUSDCNY")` | 只有 5 列，⛔ 不要画成交量

| | 「黄金盘中怎么走的」 | `ashare_minute(code="fuGC")` | 只有 `price` / `time`，⛔ 不能说有量

| | 「黄金买一卖一多少 / 合约哪天到期」 | `/v1/futures?code=fuGC`（REST） | 24 列快照：`askPrice`/`bidPrice`、`expiryDate`、`dailyOIChange`

| | 「螺纹钢 / 沪铜 / IF 股指期货」 | **取不到**，直接说明 | 内盘整块没有，⛔ 别拿外盘同名品种冒充

 「黄金现在多少钱」
 `ashare_kline(code="fuGC", period="day", count=1)`
 取 `data[0].last`；顺便 `openInterest` 看持仓

 「原油 / 铜 / 美债走势」
 `ashare_kline(code="fuCL" / "fuHG" / "fuZN")`
 同一字段，换代码

 「欧元美元 / 美元人民币汇率」
 `ashare_kline(code="fxEURUSD" / "fxUSDCNY")`
 只有 5 列，⛔ 不要画成交量

 「黄金盘中怎么走的」
 `ashare_minute(code="fuGC")`
 只有 `price` / `time`，⛔ 不能说有量

 「黄金买一卖一多少 / 合约哪天到期」
 `/v1/futures?code=fuGC`（REST）
 24 列快照：`askPrice`/`bidPrice`、`expiryDate`、`dailyOIChange`

 「螺纹钢 / 沪铜 / IF 股指期货」
 **取不到**，直接说明
 内盘整块没有，⛔ 别拿外盘同名品种冒充

 ⚠️ **Agent 的三条纪律**：① 期货外汇**没有 season / year**，也**不吃 start / end**，用 `count` 控制条数；② 外汇 **无成交量**，任何"放量"结论都无依据；③ `fu6*` 是期货合约价，⛔ 不能说成汇率。

## 全部接口（5 个，一个不落）
 两个专用快照端点 + 三个通用端点：
 |
| | 端点 | 给什么 | 档位

| | [/v1/futures](/docs/endpoints/futures) | **期货实时快照 24 列**：买卖价、结算价与昨收、持仓量 + 当日增减、到期日、52 周高低、VWAP、延迟标记 | 机构版

| | [/v1/forex](/docs/endpoints/forex) | **外汇现货实时报价 14 列**：最新价、买卖价、涨跌幅、开高低、前收、市场状态 | 机构版

| | [/v1/kline](/docs/endpoints/kline) | 日 / 周 / 月 K 线（期货 7 列 / 外汇 5 列）· 最多 1212 条 | 免费

| | [/v1/minute](/docs/endpoints/minute) | 当日 / 近 5 日分时（只有 `price` + `time`） | 标准版起

| | [/v1/quote](/docs/endpoints/quote) | 最新一根日线（现价 / 开高低 / 量 / 持仓） | 免费

 [/v1/futures](/docs/endpoints/futures)
 **期货实时快照 24 列**：买卖价、结算价与昨收、持仓量 + 当日增减、到期日、52 周高低、VWAP、延迟标记
 机构版

 [/v1/forex](/docs/endpoints/forex)
 **外汇现货实时报价 14 列**：最新价、买卖价、涨跌幅、开高低、前收、市场状态
 机构版

 [/v1/kline](/docs/endpoints/kline)
 日 / 周 / 月 K 线（期货 7 列 / 外汇 5 列）· 最多 1212 条
 免费

 [/v1/minute](/docs/endpoints/minute)
 当日 / 近 5 日分时（只有 `price` + `time`）
 标准版起

 [/v1/quote](/docs/endpoints/quote)
 最新一根日线（现价 / 开高低 / 量 / 持仓）
 免费

## 边界先说清（省你试错）
 这些不是"没做好"，是数据源就没有：

 内盘商品期货整块没有
 螺纹 / 铁矿 / 沪铜 / 豆粕 / PTA / SC 原油：关键词搜索零命中。要内盘请另找数据源。

 国内股指期货 / 国债期货没有
 IF / IC / IM / IH、T / TF / TS 全部零命中。境外股指期货有（`fuES` `fuNQ` `fuYM` `fuCN`）。

 没有季线 / 年线
 `period=season` / `year` 对期货外汇直接 422，只有 `day` / `week` / `month`。

 不吃 `start` / `end`
 传日期范围一律 422（两类标的在两条通道上口径不同，带范围会给出不同价格口径）⇒ 用 `count` 取最近 N 条。

 外汇没有成交量
 外汇 K 线只有 `date open last high low` 五列 —— 做图只能画价格，⛔ 不能画量、不能算量比。

 分时只有价格
 [/v1/minute](/docs/endpoints/minute) 对期货外汇只返回 `price` + `time`，没有成交量 / 成交额，也没有均价线。

 软商品 / VIX 没有
 糖 / 棉花 / 咖啡 / 可可 / 木材 / 橙汁、VIX 波动率期货：全部零命中。

 两个银行间品种取不到
 `spAU9999`（黄金9999）/ `spPT9995`（铂金9995）搜得到但无行情 ⇒ 不在白名单内。

## 常见问题
 黄金是现货还是期货？
 两者都有：**COMEX 黄金期货 fuGC**（有持仓量、有到期日），**伦敦金现货 hf_XAU**（银行间柜台）。做趋势研究用 `fuGC`，要现货价用 `hf_XAU`。

 能取多少历史？
 `count` 最多 1212 条；日线即约 5 年，周 / 月线更长。⛔ 不能按起止日期取，只能"最近 N 条"。

 外汇能做技术指标吗？
 [/v1/technical](/docs/endpoints/technical) 目前只对 A 股 / ETF 等标的开放，期货外汇请用 K 线自己算，或只用 OHLC 做形态判断。

 `fu6E` 和 `fxEURUSD` 有什么区别？
 `fu6E` 是 **CME 欧元期货合约**（含基差、有到期日、价含升贴水），`fxEURUSD` 是**即期汇率**。做结汇 / 做账只能用后者。

 能做跨市场策略吗？
 数据齐了：A 股 + 港股 + 美股 + ETF + 外盘期货 + 外汇现货，同一个 Key、同一套字段命名。策略本身要你自己写 —— 我们只提供数据与验证。

## 想再深入
 相关文档与端点说明：
 [K 线端点（8 列与标的边界）
 期货 7 列 / 外汇 5 列 · 为什么不吃 start/end](/docs/endpoints/kline)[分时端点
 只有 price/time · 与分钟 K 线的区别](/docs/endpoints/minute)[全部端点清单
 按分类浏览全部端点](/endpoints)

 用一条黄金 K 线试一下
 日 / 周 / 月 K 线属免费档；分时标准版起；**买卖价 / 结算价 / 到期日这类实时快照**属机构版。
 [MCP 接入说明](/mcp)[查看定价](/pricing)
