贵金属API对接指南：实时行情与K线数据获取

​

概述

本文档详细介绍了贵金属行情数据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
  }
}

字段说明

Depth字段：买1-5及卖1-5价量数据

• Buy：买入盘口

• Sell：卖出盘口

BS字段：实时成交数据

• time：时间

• price：价格

• size：成交量

• direction：方向（1：卖，2：买）

Info字段：其他产品信息

• TotalAmount：当日成交额

• LimitUp：涨停价

• LimitDown：跌停价

• TurnoverRate：换手率

• QRR：量比

• MarketCAP：总市值

• MarketCIR：流通市值

二、K线图接口

接口地址

K线图接口地址39.107.99.235:1008/redis.php?code=f...

请求参数

数据量限制

• 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
  ]
]

字段说明

本作品采用《CC 协议》，转载必须注明作者和本文链接