数据API接入教程

数据API（购买 / 试用 / 密钥 / 接口文档）数据中心（网页查看）

本页说明如何把九期网的期货手续费、保证金数据接入你自己的程序或网站：开通步骤、推荐的网站接入方式、各语言示例代码，以及接入时最常遇到的问题和解决办法。

一、接入前准备

• 九期网账号：没有的话先点页面右上角「快速注册」。
• 一台有固定公网 IP 的服务器：接口只接受已绑定 IP 发来的请求。阿里云、腾讯云等云服务器的公网 IP 是固定的；家用宽带的 IP 经常变化，只适合临时测试。
• 任意能发 HTTPS 请求的语言：PHP、Python、Java、Go、Node.js、C# 等都可以；只支持 GET，返回 UTF-8 编码的 JSON。

二、开通步骤

1. 登录后打开数据API页面，在「我的数据API」点「免费试用 7 天」（含专业版全部接口，历史数据可查最近 7 天，每天 1,000 次，每个账号限领一次）；或在「购买 / 续费」选择基础版、专业版付款，付款成功后自动开通。
2. 点「生成密钥」。密钥形如 q9_ 加 40 位字母数字，只显示一次，请立即复制保存到服务器的配置文件或环境变量里。遗失只能重新生成，重新生成后旧密钥立即失效。
3. 查出服务器的公网 IP：在服务器上执行下面的命令（还没绑定 IP 时会返回 ip_not_bound，提示里的「当前请求 IP」就是要绑定的 IP）：

   curl -s "https://www.9qihuo.com/api/data/v1/meta" -H "X-API-Key: 你的密钥"

   也可以执行 curl -4 ifconfig.me。注意要填公网 IP，不是服务器网卡上的内网 IP（10.x、172.16～31.x、192.168.x 开头的都是内网 IP）。
4. 把 IP 填到「绑定服务器 IP」，每行一个，最多 5 个（例如正式服务器、备用服务器、自己电脑各一个），点「保存 IP」，立即生效。
5. 再执行一次第 3 步的命令，返回 "ok":true 和套餐信息就说明接通了（meta 不计调用次数）。
6. 按下面的示例写定时任务，把数据存到你自己的数据库或文件里。

只想看数据、不写程序：开通后直接打开数据中心，可按交易所、品种筛选，导出 CSV 用 Excel 打开。

三、接入自己网站的推荐做法

你的服务器定时拉取 → 存到你的数据库 / 缓存文件 → 你的网页从本地读取展示。

• 不要在网页的 JavaScript 里直接调用接口：密钥会暴露给所有访客；访客的 IP 不是你绑定的服务器 IP，会返回 403；接口也不允许浏览器跨域调用（CORS）。
• 不要每个访客打开页面就请求一次：数据一天只更新几次。每晚 21 点夜盘开盘后按交易所最新参数重新计算，21:40、22:40、23:40 更新，日间在 3:40、8:40、12:40、17:40、20:40 更新。建议每小时第 45 分钟拉一次。
• 一次取全部，再在本地按品种拆分：futures 不带参数一次返回全部约 850 个期货合约（90 个品种，每个品种最多十几个合约），options 一次返回全部期权品种。
• 可以先查 meta（不计次数）：比较 futures_fee_updated、price_updated，没有变化就不用重新拉取。
• 请求失败时保留上一次的数据，不要用空数据覆盖，等下一次定时任务再取。

一手保证金（margin_lot）、按金额收取的每手手续费（fee_*_yuan）按昨结算价计算，每个交易日都会变化；保证金率、手续费标准只有交易所调整时才变。

四、示例代码

PHP：定时拉取全部期货合约，存成本地文件

<?php
// fetch_9qihuo.php，用定时任务运行：45 * * * * php /path/fetch_9qihuo.php
$key = getenv('Q9_API_KEY');                 // 密钥放环境变量或配置文件，不要写进网页
$ch = curl_init('https://www.9qihuo.com/api/data/v1/futures');
curl_setopt_array($ch, array(
    CURLOPT_HTTPHEADER => array('X-API-Key: ' . $key),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
));
$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$res = json_decode((string) $body, true);
if ($code !== 200 || empty($res['ok'])) {
    // 失败时保留上一次的文件；记录 error 和 message 方便排查
    error_log('9qihuo api ' . $code . ' ' . ($res['error'] ?? '') . ' ' . ($res['message'] ?? ''));
    exit(1);
}
file_put_contents(__DIR__ . '/futures.json.tmp', json_encode($res['data'], JSON_UNESCAPED_UNICODE));
rename(__DIR__ . '/futures.json.tmp', __DIR__ . '/futures.json');

// 网页里读取（不访问九期网）：
// $rows = json_decode(file_get_contents('/path/futures.json'), true);
// foreach ($rows as $r) { if ($r['pid'] === 'rb') echo $r['id'], ' ', $r['fee_open'], ' ', $r['margin_lot'], "\n"; }

Python

import os, time, requests

KEY = os.environ["Q9_API_KEY"]
BASE = "https://www.9qihuo.com/api/data/v1/"

def get(endpoint, **params):
    for i in range(3):
        r = requests.get(BASE + endpoint, params=params, headers={"X-API-Key": KEY}, timeout=20)
        if r.status_code == 429 and "json" not in r.headers.get("Content-Type", ""):
            time.sleep(3 * (i + 1))      # 请求过快，等几秒重试
            continue
        d = r.json()
        if not d.get("ok"):
            raise RuntimeError(f"{r.status_code} {d.get('error')} {d.get('message')}")
        return d
    raise RuntimeError("请求过快，重试后仍失败")

futures = get("futures")["data"]                    # 全部期货合约
rb = [c for c in futures if c["pid"] == "rb"]       # 本地按品种筛选
main = get("futures", main=1)["data"]               # 只要主力合约
day = get("history", date="2026-11-03", pid="rb")  # 某一天（专业版 / 试用版）

Node.js（18 及以上，服务器端运行）

const BASE = 'https://www.9qihuo.com/api/data/v1/';
async function get(endpoint, params = {}) {
  const r = await fetch(BASE + endpoint + '?' + new URLSearchParams(params), {
    headers: { 'X-API-Key': process.env.Q9_API_KEY },
  });
  const d = await r.json().catch(() => ({}));
  if (!r.ok || !d.ok) throw new Error(`${r.status} ${d.error || ''} ${d.message || ''}`);
  return d;
}
get('futures', { pid: 'rb' }).then(d => console.log(d.count, d.data[0]));

命令行测试

curl -s "https://www.9qihuo.com/api/data/v1/futures?pid=rb" -H "X-API-Key: 你的密钥"
curl -s "https://www.9qihuo.com/api/data/v1/history?date=2026-11-03&exch=SHFE" -H "X-API-Key: 你的密钥"

五、历史数据（专业版、试用版）

• history?date=YYYY-MM-DD：查某一天收盘后（23:50）各合约的保证金率、手续费、最小开仓手数、单笔下单上限，即当晚夜盘开盘重算后九期网显示的数值。可加 exch、pid、id 筛选。
  • 手续费可查 2026-03-27 以后任意一天；保证金每日快照从 2026-11-03 开始，之前的日期只返回手续费（保证金等字段为 null，source 为 fee_history）。
  • 周末、节假日没有快照，返回此前最近一个交易日的数据，snapshot_date 是实际快照日期。当天 23:50 之前查今天，返回的是上一个快照。
• fee-changes?since=YYYY-MM-DD：手续费调整记录，每条带调整前的数值（prev），适合做「手续费调整提醒」。
• margin-changes?since=YYYY-MM-DD：保证金率调整记录（相邻两天快照比对得出）。
• 试用版这三个接口只能查最近 7 天（不带 since 时自动从可查的最早日期开始）；专业版不受此限制。

六、常见问题

以上都没有解决：请把接口返回的完整 JSON（含 error 和 message）、请求时间和你的服务器 IP 发给九期网客服。