接入教程（步骤、示例代码、常见问题）数据中心（网页直接查看 / 导出）
九期网整理的国内期货、期权交易参数接口：交易所标准手续费、保证金率、一手保证金、每跳价值、最小开仓手数、单笔最大下单手数，期货覆盖上期所、能源中心、大商所、郑商所、广期所、中金所全部在交易合约，期权覆盖上期所、能源中心、大商所、郑商所、广期所的商品期权。每晚 21 点夜盘开盘后按交易所最新参数重新计算，21:40、22:40、23:40 及日间多次更新。
套餐
| 套餐 | 年费 | 内容 | 每日调用 |
|---|---|---|---|
| 试用版 | 免费 7 天 | 专业版全部接口，历史数据只能查最近 7 天；每个账号限领一次，登录后在下方「我的数据API」一键领取 | 1,000 次 |
| 基础版 | ¥2,980 | 期货合约参数、期权品种参数、品种列表 | 10,000 次 |
| 专业版 | ¥6,980 | 基础版全部内容 + 查询历史某一天的手续费（2026-03-27 起）与保证金率（每日快照，2026-11-03 起）+ 手续费、保证金调整记录 | 50,000 次 |
一次请求可取回全部期货合约（约 850 个）或某个品种的全部合约。数据每天只更新几次，网站接入建议服务器定时拉取后缓存，详见接入教程。每个密钥最多绑定 5 个服务器 IP，仅绑定的 IP 可调用；数据中心网页查看不受 IP 限制，与 API 共用每日次数。数据仅供参考，以交易所和期货公司公告为准；禁止转售或公开发布。
购买 / 续费
需先登录九期网账号。付款成功后自动开通，在下方「我的数据API」生成密钥、绑定 IP 即可调用。续费在剩余时间上顺延；从基础版升级到专业版时，剩余时间按金额折算后并入专业版；试用期内购买从付款时起算。
我的数据API
加载中…
接口文档
地址：https://www.9qihuo.com/api/data/v1/{接口名}，只支持 GET。请求头带 X-API-Key: 你的密钥，返回 JSON（UTF-8）。
curl -H "X-API-Key: q9_xxxxxxxx" "https://www.9qihuo.com/api/data/v1/futures?pid=rb"
| 接口 | 参数（均可选） | 说明 | 套餐 |
|---|---|---|---|
meta | 各数据更新时间、当前套餐、到期时间、今日已用次数（不计次数） | 全部 | |
products | 期货、期权品种列表 | 全部 | |
futures | exch pid id main=1 | 期货合约参数，可按交易所、品种、合约、主力筛选 | 全部 |
options | exch pid | 期权品种手续费与下单限制 | 全部 |
fee-changes | since=YYYY-MM-DD（默认近 30 天） exch pid id | 手续费调整记录，含调整前数值（prev，新合约为 null），最新在前，单次最多 1000 条 | 专业版 |
margin-changes | 同上 | 保证金率调整记录（按每日收盘后快照比对） | 专业版 |
history | date=YYYY-MM-DD（默认今天） exch pid id | 某一天收盘后（23:50）各合约的保证金率、手续费、最小开仓与单笔下单上限。2026-11-03 之前只有手续费（保证金等字段为 null）；非交易日返回此前最近一次快照（见 snapshot_date） | 专业版 |
试用版可调用全部接口（含专业版接口），其中 history、fee-changes、margin-changes 只能查最近 7 天。
交易所代码：SHFE 上期所、INE 能源中心、DCE 大商所、CZCE 郑商所、GFEX 广期所、CFFEX 中金所。
futures 字段
| 字段 | 说明 |
|---|---|
id pid name exch | 合约代码、品种代码、品种名、交易所 |
main | 是否主力合约 |
price | 计算用的昨结算价 |
mult tick expire | 合约乘数、最小变动价位、到期日 |
margin_long margin_short | 多 / 空保证金率（%） |
margin_lot | 一手保证金（元）= 多头保证金率 × 昨结算价 × 合约乘数 |
fee_mode | volume 按手收取（元/手）；money 按成交金额收取（万分之） |
fee_open fee_close fee_close_today | 开仓、平昨、平今手续费（交易所标准，单位见 fee_mode） |
fee_open_yuan fee_close_yuan fee_close_today_yuan | 按金额收取时折算的每手金额（元）；按手收取时为 null |
fee_round_trip | 一手开仓 + 平今合计（元） |
tick_gross tick_net | 每跳价值（元）、每跳扣除开平手续费后的净值（元） |
min_open min_open_eff | 最小开仓手数（0 表示新合约待交易所公告）、生效日期 |
max_limit max_market | 限价、市价单笔最大下单手数 |
错误码
| HTTP | error | 说明 |
|---|---|---|
| 401 | missing_key / invalid_key | 缺少或无效的密钥 |
| 403 | expired / no_plan / plan | 会员已到期 / 未开通 / 套餐不含该接口 |
| 403 | ip_not_bound / ip_not_allowed | 未绑定 IP / 当前 IP 未绑定 |
| 403 | trial_range | 试用版查询的历史日期超出最近 7 天 |
| 400 | bad_date / bad_since | 日期格式不对或超出可查范围 |
| 429 | quota 或无 JSON | 今日次数用完 / 请求过快（每个密钥每秒最多 2 次） |
每种错误的原因和解决办法见接入教程 · 常见问题。
