期货数据对接指南，用于获取黄金、白银、原油等大宗商品的数据。
1. 基础配置[*]接口域名: https://api.stocktv.top
[*]期货基础路径: /futures
[*]认证方式: URL 参数 key=您的API密钥
2. 核心对接流程
第一步：获取期货品种列表 (查找 Symbol)
由于期货合约代码（Symbol）可能因交易所不同而有所差异（例如黄金可能是 XAU、GC 或 Gold），第一步必须先拉取列表，找到对应的 symbol。
[*]接口: /futures/list
[*]方法: GET
[*]参数: key
[*]请求示例:GET https://api.stocktv.top/futures/list?key=YOUR_KEY
[*]如何查找:
[*]黄金: 搜索关键词 "Gold" 或 "XAU"
[*]白银: 搜索关键词 "Silver" 或 "XAG"
[*]原油: 搜索关键词 "Oil", "WTI", "Brent" 或 "CL"
第二步：获取实时行情 (Real-time Quote)
获取特定品种的最新买卖价、涨跌幅。
[*]接口: /futures/querySymbol
[*]方法: GET
[*]参数:
[*]symbol: 品种代码 (第一步获取的)
[*]请求示例 (假设黄金代码为 XAU):GET https://api.stocktv.top/futures/querySymbol?symbol=XAU&key=YOUR_KEY
[*]响应示例:{
"code": 200,
"data": [
{
"symbol": "XAU",
"name": "Gold Spot",
"buy": "2350.50", // 买价
"sell": "2350.80", // 卖价
"last_price": "2350.60", // 最新价
"chg_pct": "0.45", // 涨跌幅
"time": "2024-05-20"
}
]
}
第三步：获取 K 线数据 (Chart Data)
获取用于绘制图表的历史数据。
[*]接口: /futures/kline
[*]方法: GET
[*]参数:
[*]symbol: 品种代码
[*]interval: 周期 (注意期货接口的周期定义与股票略有不同)
[*]1, 5, 15, 30, 60 (分钟)
[*]1d (日线)
[*]请求示例:GET https://api.stocktv.top/futures/kline?symbol=XAU&interval=1d&key=YOUR_KEY
3. 完整代码示例 (HTML + JavaScript)
这是一个完整的演示页面。它包含两个功能：
[*]自动搜索品种：点击按钮自动在列表中查找黄金、白银、原油的 Symbol。
[*]渲染图表：使用找到的 Symbol 绘制 K 线图。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>StockTV 期货行情 (黄金/原油)</title>
</head>
<body>
<h2>StockTV 全球期货数据演示</h2>
请点击下方按钮加载数据...
<button onclick="loadCommodity('Gold', '黄金')">加载 黄金 (Gold)</button>
<button onclick="loadCommodity('Silver', '白银')">加载 白银 (Silver)</button>
<button onclick="loadCommodity('Oil', '原油')">加载 原油 (Oil)</button>
<button onclick="loadCommodity('Gas', '天然气')">加载 天然气 (Gas)</button>
</body>
</html>
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]