期货实时数据

获取国际期货实时行情,覆盖能源、金属、农产品等主要品种。做商品市场监控或周期股研究时,商品价格是绕不开的先行指标。

说明:套餐用户请把 apiKey 替换为 apiToken 调用接口。

接口地址: api.cxdy.vip/api/qhss

返回格式: JSON

请求方式: GET

请求示例: https://api.cxdy.vip/api/qhss?apiKey=你的apiKey

请求参数说明:

🔑 鉴权凭证(二选一,以查询参数方式随请求传入):
apiKey — 单接口购买用户的密钥,购买后在会员中心获取;
apiToken — 套餐用户的访问令牌,在会员中心生成。

返回参数说明:

名称 类型 说明
序号 int 序号
代码 string 证券代码
名称 string 证券简称
最新价 int 最新价(元)
涨跌额 int 涨跌额(元)
涨跌幅 float 涨跌幅(%)
今开 int 今日开盘价(元)
最高 int 最高价(元)
最低 int 最低价(元)
昨结 int 昨日结算价
成交量 int 成交量
买盘 int 买盘(外盘)量
卖盘 int 卖盘(内盘)量
持仓量 int 持仓量(手)

返回示例:

[{
		"序号": 579,
		"代码": "LTNT",
		"名称": "综合锡03",
		"最新价": 31725,
		"涨跌额": -340,
		"涨跌幅": -1.07,
		"今开": 31725,
		"最高": 31480,
		"最低": 31480,
		"昨结": 31820,
		"成交量": 0,
		"买盘": 0,
		"卖盘": 0,
		"持仓量": 0
	},
	{
		"序号": 580,
		"代码": "NG25H",
		"名称": "天然气2503",
		"最新价": 3.209,
		"涨跌额": -0.035,
		"涨跌幅": -1.08,
		"今开": 3.209,
		"最高": 3.208,
		"最低": 3.208,
		"昨结": 3.243,
		"成交量": 48,
		"买盘": 33,
		"卖盘": 15,
		"持仓量": 80720
	}
]

错误码格式说明:

名称 类型 说明
200 int 请求成功
203 int 请求过于频繁(触发限流),请稍后再试
400 int 请求参数错误:缺少必填参数或参数格式不正确
401 int 鉴权失败:apiKey 无效、API Token 无效或已过期、付费接口未传有效凭证
403 int 拒绝访问:接口已到期请续费,或账号/IP 因违规调用被临时封禁
404 int 接口不存在或已下架;或来源 IP 不在该接口的 IP 白名单内
429 int 调用超限:免费/套餐/单接口用户的当日调用次数已达上限
500 int 服务器错误:上游数据源暂时不可用,请稍后重试

代码示例:

curl 请求示例(apiKey,单接口购买用户):
curl "https://api.cxdy.vip/api/qhss?apiKey=你的apiKey"

curl 请求示例(apiToken,套餐用户):
curl "https://api.cxdy.vip/api/qhss?apiToken=你的apiToken"

PHP 请求示例:
<?php
// 套餐用户请将 apiKey=你的apiKey 换成 apiToken=你的apiToken
$ch = curl_init('https://api.cxdy.vip/api/qhss?apiKey=你的apiKey');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python 请求示例:
import requests

url = "https://api.cxdy.vip/api/qhss"
params = {"apiKey": "你的apiKey"} # 套餐用户将 apiKey 换成 apiToken
response = requests.get(url, params=params)
print(response.json())

请求参数设置:

参数名称 参数值
[{
		"序号": 579,
		"代码": "LTNT",
		"名称": "综合锡03",
		"最新价": 31725,
		"涨跌额": -340,
		"涨跌幅": -1.07,
		"今开": 31725,
		"最高": 31480,
		"最低": 31480,
		"昨结": 31820,
		"成交量": 0,
		"买盘": 0,
		"卖盘": 0,
		"持仓量": 0
	},
	{
		"序号": 580,
		"代码": "NG25H",
		"名称": "天然气2503",
		"最新价": 3.209,
		"涨跌额": -0.035,
		"涨跌幅": -1.08,
		"今开": 3.209,
		"最高": 3.208,
		"最低": 3.208,
		"昨结": 3.243,
		"成交量": 48,
		"买盘": 33,
		"卖盘": 15,
		"持仓量": 80720
	}
]