概述

本文档详细介绍了贵金属行情数据API的对接流程，包括WebSocket实时数据推送和K线数据接口的使用方法。在开始对接前，请务必联系客服授权您的服务器IP地址。

一、WebSocket实时数据推送

连接信息

• WebSocket地址：ws://39.107.99.235/ws

重要注意事项

1. 断线重连机制：因网络不稳定可能导致连接中断，客户端必须实现自动重连机制

2. 实时推送：行情更新即推送

3. 订阅优化：每个产品只需订阅一次，节约资源

接口使用详解

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	成交量