黄金、碳排放期货市场API接口文档

StockTV 提供了多种期货市场的数据接口，包括获取K线图表数据、查询特定期货的实时行情等。以下为对接期货市场的详细接口说明。

一、获取K线图表数据

通过调用/futures/kline接口，您可以获取指定期货合约的历史K线数据（例如开盘价、最高价、最低价、收盘价、成交量等）。

• 请求方法：GET
• URL：https://api.stocktv.top/futures/kline
• 参数：
  • key: 您的API密钥。
  • symbol: 交易对（如：“EUA”）。
  • interval: 时间间隔，支持 “1”, “5”, “15”, “30”, “60”, “1d”。

示例代码：

<?php
function getKLineData($symbol, $interval) {
    $url = "https://api.stocktv.top/futures/kline";
    $params = [
        'key' => '您的API密钥',
        'symbol' => $symbol,
        'interval' => $interval
    ];

    $query = http_build_query($params);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "$url?$query");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    if(curl_errno($ch)) {
        echo 'Error:' . curl_error($ch);
    }
    curl_close($ch);

    return json_decode($response, true);
}

$kLineData = getKLineData('EUA', '1');
print_r($kLineData);
?>

返回的数据将包含多个时间段的K线信息，每个时间段的信息如下所示：

{
    "date": "2024-08-07 20:29:00",
    "volume": "14",
    "high": "71.082",
    "low": "71.082",
    "close": "71.082",
    "open": "71.082",
    "timestamp": 1723062540.0
}

二、查询特定期货的当前期货行情

使用/futures/querySymbol接口可以查询特定期货合约的最新行情信息，如买价、卖价、最高价、最低价等。

• 请求方法：GET
• URL：https://api.stocktv.top/futures/querySymbol
• 参数：
  • key: 您的API密钥。
  • symbol: 交易对（如：“XAG”）。

示例代码：

<?php
function getFutureQuote($symbol) {
    $url = "https://api.stocktv.top/futures/querySymbol";
    $params = [
        'key' => '您的API密钥',
        'symbol' => $symbol
    ];

    $query = http_build_query($params);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "$url?$query");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    if(curl_errno($ch)) {
        echo 'Error:' . curl_error($ch);
    }
    curl_close($ch);

    return json_decode($response, true);
}

$futureQuote = getFutureQuote('XAG');
print_r($futureQuote);
?>

返回的数据结构示例如下：

{
    "date": "17:57:41",
    "symbol": "FEF",
    "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"
}

注意事项

• 确保替换 '您的API密钥' 为您实际从StockTV获得的API密钥。
• 根据需要调整 symbol 和 interval 参数以适应不同的市场需求。
• 在生产环境中，请妥善处理错误和异常情况，比如网络问题或API响应错误等。
• 对于WebSocket连接的需求，参考官方文档中关于实时数据流的部分进行设置。

通过上述步骤，您能够轻松地使用PHP对接StockTV提供的期货市场API，并从中获取所需的数据用于分析或其他用途。希望这篇指南能为您提供帮助！对于更多高级功能，请参考StockTV官方文档进行深入探索。