外盘期货与外汇:黄金、原油、美债、汇率,一套接口
做跨市场研究,最先卡住的往往不是策略,而是黄金和美元指数去哪儿取。我们把这部分接上了:外盘期货 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 两列(没有成交量 / 成交额) |
/v1/kline?code=fuGCdate open last high low volume openInterest 7 列(实测 2026-11-10 收 4132.9 · 持仓 247,993)/v1/kline?code=fuCL · fuHG · fuZN · fuES/v1/kline?code=fxEURUSD/v1/minute?code=fuGCprice + time 两列(没有成交量 / 成交额)⇒ 代码规则:期货前缀 fu(fuGC)/ 外汇前缀 fx(fxEURUSD)/ 香港指数期货 r_hd*(r_hdHSImain)。同一个 Key,跟其他代码共用额度。
品种白名单(55 个外盘期货 + 10 个外汇现货)
逐个 quote 验活过的清单,⛔ 不在清单里的代码取不到数。搜得到不等于取得到 —— 银行间 spAU9999 / spPT9995 能搜到但无行情,已剔除。
COMEX 黄金 fuGC · COMEX 白银 fuSI · NYMEX 铂金 fuPL · NYMEX 钯金 fuPA · COMEX 微型黄金 fuMGC · 伦敦金现货 hf_XAU · 伦敦银现货 hf_XAG · 伦敦铂金现货 hf_XPT
WTI 原油 fuCL · 布伦特原油 hf_OIL · NYMEX 天然气 fuNG · NYMEX 汽油 fuRB · NYMEX 燃油 fuHO
COMEX 铜 fuHG · LME 铜 hf_CAD · LME 铝 hf_AHD · LME 镍 hf_NID · LME 锌 hf_ZSD · LME 铅 hf_PBD · LME 锡 hf_SND
CBOT 玉米 fuZC · 大豆 fuZS · 豆油 fuZL · 豆粕 fuZM · 小麦 fuZW · 稻谷 fuZR · 燕麦 fuZO · CME 活牛 fuLE · 瘦肉猪 fuHE · 育肥牛 fuGF
富时A50 fuCN · 标普500 fuES · 纳指100 fuNQ · 道指 fuYM · 罗素2000 fuRTY · 日经 fuNIY · 美元日经 fuNKD · 恒指 r_hdHSImain · 小恒指 r_hdMHImain · 恒生科技 r_hdHTImain · 恒生国企 r_hdHHImain
10年美债 fuZN · 5年美债 fuZF · 2年美债 fuZT · 30年美债 fuZB · 超10年美债 fuTN · 超30年美债 fuUB · 30天联邦基金 fuZQ
CME 欧元 fu6E · 英镑 fu6B · 加元 fu6C · 澳元 fu6A · 墨西哥比索 fu6M · 瑞郎 fu6S · 纽元 fu6N
美元人民币 fxUSDCNY · 离岸人民币 fxCNH · 欧元人民币 fxEURCNY · 港币人民币 fxHKDCNY · 人民币日元 fxCNYJPY · 美元指数 fxDINIW · 欧元美元 fxEURUSD · 美元日元 fxUSDJPY · 英镑美元 fxGBPUSD · 美元港币 fxUSDHKD
🔴 fu6* 是 CME 外汇期货合约(含基差、有到期日),不是即期汇率 ⇒ ⛔ 别拿去当"澳元汇率"做账。要即期汇率只能用 fx* 那 10 个。
字段:期货 7 列、外汇 5 列,不一样
同一个 /v1/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 | price time 两列 | price time 两列 |
| 实时快照(专用端点) | 24 列(/v1/futures):买卖价 / 结算价 / 持仓变化 / 到期日 / 52 周高低 | 14 列(/v1/forex):买卖价 / 涨跌幅 / 市场状态(最新价字段叫 price) |
date open last high low volume openInterestdate open last high lowvolume · openInterest)amount / 换手 turnoverprice)⚠️ 收盘价字段名是 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")ashare_minute(code="fuGC")price / time,⛔ 不能说有量/v1/futures?code=fuGC(REST)askPrice/bidPrice、expiryDate、dailyOIChange⚠️ Agent 的三条纪律:① 期货外汇没有 season / year,也不吃 start/end,用 count 控制条数;② 外汇 无成交量,任何"放量"结论都无依据;③ fu6* 是期货合约价,⛔ 不能说成汇率。
全部接口(5 个,一个不落)
两个专用快照端点 + 三个通用端点:
| 端点 | 给什么 | 档位 |
|---|---|---|
| /v1/futures | 期货实时快照 24 列:买卖价、结算价与昨收、持仓量 + 当日增减、到期日、52 周高低、VWAP、延迟标记 | 机构版 |
| /v1/forex | 外汇现货实时报价 14 列:最新价、买卖价、涨跌幅、开高低、前收、市场状态 | 机构版 |
| /v1/kline | 日 / 周 / 月 K 线(期货 7 列 / 外汇 5 列)· 最多 1212 条 | 免费 |
| /v1/minute | 当日 / 近 5 日分时(只有 price + time) | 标准版起 |
| /v1/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 对期货外汇只返回 price + time,没有成交量 / 成交额,也没有均价线。
糖 / 棉花 / 咖啡 / 可可 / 木材 / 橙汁、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、同一套字段命名。策略本身要你自己写 —— 我们只提供数据与验证。