国际期货数据接口文档
概述
本接口提供伦敦金、原油、碳排放等国际期货市场的实时行情数据,包括市场列表、实时行情和K线数据。
接口列表
1. 期货市场列表
接口地址: GET /futures/list
请求参数:
参数名类型必填说明keystring是API密钥响应示例:- {
- "code": 200,
- "message": "操作成功",
- "data": [
- {
- "date": "17:57:41",
- "symbol": "XAU", // 伦敦金交易对
- "buy": "101.100", // 当前买价
- "sell": "101.200", // 当前卖价
- "high_price": "102.600", // 最高价
- "prev_price": "99.460", // 前收盘价
- "volume": "372006.000", // 交易量
- "name": "伦敦金", // 名称
- "time": "2024-08-09", // 日期
- "low_price": "99.450", // 最低价
- "open_price": "99.700", // 开盘价
- "last_price": "101.250", // 最新价
- "chg": "2.215", // 涨跌额
- "chg_pct": "0.022" // 涨跌百分比
- },
- {
- "date": "17:57:56",
- "symbol": "CL", // 原油交易对
- "buy": "3749.000",
- "sell": "3750.000",
- "high_price": "3767.000",
- "prev_price": "3704.000",
- "volume": "80515.000",
- "name": "WTI原油",
- "time": "2024-08-09",
- "low_price": "3709.000",
- "open_price": "3751.000",
- "last_price": "3750.800",
- "chg": "2.215",
- "chg_pct": "0.022"
- },
- {
- "date": "17:57:56",
- "symbol": "EUA", // 碳排放交易对
- "buy": "71.100",
- "sell": "71.200",
- "high_price": "72.600",
- "prev_price": "70.460",
- "volume": "15000.000",
- "name": "欧盟碳排放配额",
- "time": "2024-08-09",
- "low_price": "70.450",
- "open_price": "70.700",
- "last_price": "71.250",
- "chg": "0.790",
- "chg_pct": "0.011"
- }
- ]
- }
复制代码 2. 查询特定期货行情
接口地址: GET /futures/querySymbol
请求参数:
参数名类型必填说明keystring是API密钥symbolstring是交易对符号(XAU:伦敦金, CL:原油, EUA:碳排放)请求示例:- https://api.stocktv.top/futures/querySymbol?key=您的API密钥&symbol=XAU
复制代码 响应示例:- {
- "code": 200,
- "message": "操作成功",
- "data": [
- {
- "date": "17:57:41",
- "symbol": "XAU",
- "buy": "101.100",
- "sell": "101.200",
- "high_price": "102.600",
- "prev_price": "99.460",
- "volume": "372006.000",
- "name": "伦敦金",
- "time": "2024-08-09",
- "low_price": "99.450",
- "open_price": "99.700",
- "last_price": "101.250",
- "chg": "2.215",
- "chg_pct": "0.022"
- }
- ]
- }
复制代码 3. 期货K线数据
接口地址: GET /futures/kline
请求参数:
参数名类型必填说明keystring是API密钥symbolstring是交易对符号intervalstring是时间间隔:1、5、15、30、60、1d请求示例:- https://api.stocktv.top/futures/kline?key=您的API密钥&symbol=XAU&interval=5
复制代码 响应示例:- {
- "code": 200,
- "message": "操作成功",
- "data": [
- {
- "date": "2024-08-07 20:29:00", // 时间
- "volume": "14", // 交易量
- "high": "71.082", // 最高价
- "s": "0",
- "low": "71.082", // 最低价
- "position": "0",
- "close": "71.082", // 收盘价
- "open": "71.082", // 开盘价
- "timestamp": 1723062540.0 // 时间戳
- },
- {
- "date": "2024-08-07 20:30:00",
- "volume": "31",
- "high": "71.118",
- "s": "0",
- "low": "71.082",
- "position": "0",
- "close": "71.118",
- "open": "71.082",
- "timestamp": 1723062600.0
- }
- ]
- }
复制代码 支持的期货品种
伦敦金 (XAU)
- 名称: 伦敦现货黄金
- 交易时间: 24小时交易
- 报价单位: 美元/盎司
- 最小变动: 0.01美元
原油 (CL)
- 名称: WTI原油期货
- 交易时间: 几乎24小时交易
- 报价单位: 美元/桶
- 最小变动: 0.01美元
碳排放 (EUA)
- 名称: 欧盟碳排放配额
- 交易时间: 欧洲交易时段
- 报价单位: 欧元/吨
- 最小变动: 0.01欧元
使用说明
1. 获取API密钥
请联系客服获取有效的API密钥。
2. 数据格式
所有接口返回数据均为JSON格式。
3. 错误码说明
- 200: 操作成功
- 400: 参数错误
- 401: 密钥无效
- 500: 服务器内部错误
4. 请求频率限制
- 普通用户:60次/分钟
- VIP用户:300次/分钟
示例代码
Python 示例
- import requests
- # 配置参数
- API_KEY = "您的API密钥"
- BASE_URL = "https://api.stocktv.top"
- # 获取伦敦金行情
- def get_gold_price():
- url = f"{BASE_URL}/futures/querySymbol"
- params = {
- "key": API_KEY,
- "symbol": "XAU"
- }
- response = requests.get(url, params=params)
- return response.json()
- # 获取K线数据
- def get_kline_data(symbol, interval):
- url = f"{BASE_URL}/futures/kline"
- params = {
- "key": API_KEY,
- "symbol": symbol,
- "interval": interval
- }
- response = requests.get(url, params=params)
- return response.json()
复制代码 注意事项
- 实时性: 数据为实时行情,延迟在1秒以内
- 数据源: 数据来源于各大期货交易所
- 技术支持: 提供免费技术支持,全程辅助对接
- 更新频率: 行情数据每秒更新,K线数据按间隔更新
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |