当前位置：首页 > web >正文

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

web 2025/7/2 13:52:18

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