伦敦金、原油、碳排放等国际期货市场的实时行情数据 数据接口API

国际期货数据接口文档

概述

本接口提供伦敦金、原油、碳排放等国际期货市场的实时行情数据，包括市场列表、实时行情和K线数据。

接口列表

1. 期货市场列表

接口地址： GET /futures/list

请求参数：

参数名 类型 必填 说明
key string 是 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

请求参数：

参数名 类型 必填 说明
key string 是 API密钥
symbol string 是 交易对符号（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

请求参数：

参数名 类型 必填 说明
key string 是 API密钥
symbol string 是 交易对符号
interval string 是 时间间隔：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. 实时性： 数据为实时行情，延迟在1秒以内
  2. 数据源： 数据来源于各大期货交易所
  3. 技术支持： 提供免费技术支持，全程辅助对接
  4. 更新频率： 行情数据每秒更新，K线数据按间隔更新
posted @ 2025-11-26 19:06  CryptoRzz  阅读(16)  评论(0)    收藏  举报