概述
本文档详细介绍了贵金属行情数据API的对接流程，包括WebSocket实时数据推送和K线数据接口的使用方法。在开始对接前，请务必联系客服授权您的服务器IP地址。
一、WebSocket实时数据推送
连接信息
- WebSocket地址：ws://39.107.99.235/ws
重要注意事项
- 断线重连机制：因网络不稳定可能导致连接中断，客户端必须实现自动重连机制
- 实时推送：行情更新即推送
- 订阅优化：每个产品只需订阅一次，节约资源
接口使用详解
1. 心跳机制
客户端需要每隔10秒向服务端发送心跳信息：
客户端发送格式：
{"ping": 1689303517}
服务端响应格式：
{"pong": 1689303517}
2. 数据订阅
连接成功后发送订阅请求：
订阅格式：
{"Key": "XAU,GC2512"}
多个产品代码以英文逗号分隔
数据返回格式
{
"body": {
"StockCode": "XAU",
"Price": 27206.02,
"Open": 26689.98,
"LastClose": 27206.02,
"High": 27287.74,
"Low": 26554.35,
"Time": "2023-05-28 15:43:51",
"LastTime": "1685259831",
"BP1": 27206.02,
"BV1": 0.21,
"SP1": 27206.03,
"SV1": 0.78,
"TotalVol": 2293.14,
"Depth": {
"Buy": [
{"BP1": 27206.02, "BV1": 0.39},
{"BP2": 27204.14, "BV2": 0},
{"BP3": 27204.13, "BV3": 1.28},
{"BP4": 27203.32, "BV4": 0.64},
{"BP5": 27203.3, "BV5": 0.68}
],
"Sell": [
{"SP1": 27206.03, "SV1": 0.78},
{"SP2": 27206.22, "SV2": 0.04},
{"SP3": 27206.96, "SV3": 0.02},
{"SP4": 27208.13, "SV4": 0.01},
{"SP5": 27208.14, "SV5": 0.07}
]
},
"BS": [
{
"time": "15:43:51",
"price": 27206.02,
"size": 0.21,
"direction": 2
},
{
"time": "15:43:51",
"price": 27206.03,
"size": 0.78,
"direction": 1
}
],
"Info": [],
"lastSize": 0.055118,
"Diff": 516.04,
"DiffRate": 1.93
}
}
字段说明
| 字段 | 说明 |
|---|---|
| StockCode | 产品代码 |
| Price | 最新价 |
| Open | 当日开盘价 |
| LastClose | 昨日收盘价 |
| High | 当日最高价 |
| Low | 当日最低价 |
| Time | 更新时间 |
| LastTime | 更新时间戳 |
| BP1 | 买价 |
| BV1 | 买量 |
| SP1 | 卖价 |
| SV1 | 卖量 |
| TotalVol | 当日成交量 |
| DiffRate | 涨跌幅 |
| Diff | 涨跌额 |
Depth字段：买1-5及卖1-5价量数据
- Buy：买入盘口
- Sell：卖出盘口
BS字段：实时成交数据
- time：时间
- price：价格
- size：成交量
- direction：方向（1：卖，2：买）
Info字段：其他产品信息
- TotalAmount：当日成交额
- LimitUp：涨停价
- LimitDown：跌停价
- TurnoverRate：换手率
- QRR：量比
- MarketCAP：总市值
- MarketCIR：流通市值
二、K线图接口
接口地址
K线图接口地址
http://39.107.99.235:1008/redis.php?code=fx_sgbpusd&time=1m&rows=40
请求参数
| 参数 | 说明 |
|---|---|
| code | 产品代码 |
| time | 时间周期：1m、5m、15m、30m、1h、1d、1M |
| rows | 获取数据条数 |
数据量限制
- 1m：最大600条
- 5m、15m、30m、1h、1d：最大300条
- 1M（月）：最大100条
返回数据格式
[ [ 1623061860000, 36500, 36540.08, 36500, 36510.65, "2021-06-07 18:31:00", 100 ],
[ 1623061860000, 36500, 36540.08, 36500, 36510.65, "2021-06-07 18:30:00", 100 ]
]
字段说明
| 字段 | 说明 |
|---|---|
| 1623061860000 | 毫秒时间戳 |
| 36500 | 开盘价 |
| 36540.08 | 最高价 |
| 36500 | 最低价 |
| 36510.65 | 收盘价 |
| "2021-06-07 18:31:00" | 时间 |
| 100 | 成交量 |
