双十一机构版年付 ¥1,699/年查看年付
外盘期货 · 外汇

外盘期货与外汇:黄金、原油、美债、汇率,一套接口

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

一句话说清

外盘期货 7 类 55 个品种(贵金属 / 能源化工 / 基本金属 / 农产品 / 股指 / 利率 / 外汇期货)+ 10 个外汇现货,走 /v1/kline(日/周/月)与 /v1/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 两列(没有成交量 / 成交额)

⇒ 代码规则:期货前缀 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,两类标的返回的列数不同 —— 按标的判断,别硬编码列数:

K 线列数
7 列
5 列
字段
date open last high low volume openInterest
date open last high low
成交量 / 持仓量
两者都有(volume · openInterest)
🔴 都没有
成交额 amount / 换手 turnover
🔴 都没有(这两列只属 A 股)
🔴 都没有
分时 /v1/minute
price time 两列
price time 两列
实时快照(专用端点)
24 列(/v1/futures):买卖价 / 结算价 / 持仓变化 / 到期日 / 52 周高低
14 列(/v1/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 可以直接答这些问题:

「黄金现在多少钱」
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 个,一个不落)

两个专用快照端点 + 三个通用端点:

期货实时快照 24 列:买卖价、结算价与昨收、持仓量 + 当日增减、到期日、52 周高低、VWAP、延迟标记
机构版
外汇现货实时报价 14 列:最新价、买卖价、涨跌幅、开高低、前收、市场状态
机构版
日 / 周 / 月 K 线(期货 7 列 / 外汇 5 列)· 最多 1212 条
免费
当日 / 近 5 日分时(只有 price + time)
标准版起
最新一根日线(现价 / 开高低 / 量 / 持仓)
免费

边界先说清(省你试错)

这些不是"没做好",是数据源就没有:

内盘商品期货整块没有

螺纹 / 铁矿 / 沪铜 / 豆粕 / 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 对期货外汇只返回 price + time,没有成交量 / 成交额,也没有均价线。

软商品 / VIX 没有

糖 / 棉花 / 咖啡 / 可可 / 木材 / 橙汁、VIX 波动率期货:全部零命中。

两个银行间品种取不到

spAU9999(黄金9999)/ spPT9995(铂金9995)搜得到但无行情 ⇒ 不在白名单内。

常见问题

黄金是现货还是期货?

两者都有:COMEX 黄金期货 fuGC(有持仓量、有到期日),伦敦金现货 hf_XAU(银行间柜台)。做趋势研究用 fuGC,要现货价用 hf_XAU。

能取多少历史?

count 最多 1212 条;日线即约 5 年,周 / 月线更长。⛔ 不能按起止日期取,只能"最近 N 条"。

外汇能做技术指标吗?

/v1/technical 目前只对 A 股 / ETF 等标的开放,期货外汇请用 K 线自己算,或只用 OHLC 做形态判断。

fu6E 和 fxEURUSD 有什么区别?

fu6E 是 CME 欧元期货合约(含基差、有到期日、价含升贴水),fxEURUSD 是即期汇率。做结汇 / 做账只能用后者。

能做跨市场策略吗?

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

用一条黄金 K 线试一下

日 / 周 / 月 K 线属免费档;分时标准版起;买卖价 / 结算价 / 到期日这类实时快照属机构版。