期货数据对接指南，用于获取黄金、白银、原油等大宗商品的数据。

赏勿 · 昨天 16:00

1. 基础配置

2. 核心对接流程

第一步：获取期货品种列表 (查找 Symbol)

由于期货合约代码（Symbol）可能因交易所不同而有所差异（例如黄金可能是 XAU、GC 或 Gold），第一步必须先拉取列表，找到对应的 symbol。

接口: /futures/list
方法: GET
参数: key
请求示例:
1. 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):
1. GET https://api.stocktv.top/futures/querySymbol?symbol=XAU&key=YOUR_KEY
复制代码
响应示例:
1. {
2. "code": 200,
3. "data": [
4. {
5. "symbol": "XAU",
6. "name": "Gold Spot",
7. "buy": "2350.50", // 买价
8. "sell": "2350.80", // 卖价
9. "last_price": "2350.60", // 最新价
10. "chg_pct": "0.45", // 涨跌幅
11. "time": "2024-05-20"
12. }
13. ]
14. }
复制代码

第三步：获取 K 线数据 (Chart Data)

获取用于绘制图表的历史数据。

接口: /futures/kline
方法: GET
参数:
- symbol: 品种代码
- interval: 周期 (注意期货接口的周期定义与股票略有不同)
  - 1, 5, 15, 30, 60 (分钟)
  - 1d (日线)
请求示例:
1. GET https://api.stocktv.top/futures/kline?symbol=XAU&interval=1d&key=YOUR_KEY
复制代码

3. 完整代码示例 (HTML + JavaScript)

这是一个完整的演示页面。它包含两个功能：

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

账号		自动登录	找回密码
密码			立即注册