國際期貨數據接口文檔

概述

本接口提供倫敦金、原油、碳排放等國際期貨市場的實時行情數據，包括市場列表、實時行情和K線數據。

接口列表

1. 期貨市場列表

接口地址： GET /futures/list

請求參數：

響應示例：

{
  "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

請求參數：

請求示例：

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

請求參數：

請求示例：

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線數據按間隔更新