在贵金属量化交易、行情看板、跨时区价格监控等开发场景中，7×24 小时连续行情是保证系统稳定运行的关键。传统贵金属行情受交易所开市时间限制，夜间与周末容易出现数据断层，难以满足自动化程序与实时监控需求。
本文以黄金天眼行情接口为例，完整讲解**脉动行情数据****国际暗金、国际暗银**相关标的的接入方式、接口调用、常见报错处理与最佳实践，纯技术向，方便开发者快速落地。
一、支持标的与说明
接口支持 4 类贵金属连续行情标的：
- PAXG：国际暗金
- PAXS：国际暗银
- PAXGU：国际暗金（国内）
- PAXSG：国际暗银（国内）
以上品种均为24 小时连续报价，无固定休市时间，适合全天候数据采集。
二、WebSocket 实时数据对接（推荐）
WebSocket 适合需要低延迟、实时推送的场景，如行情面板、量化程序。
1. 连接地址
plaintext
ws://39.107.99.235/ws
2. 心跳保持（必须实现）
每 10 秒向服务端发送心跳，避免断开：
json
{"ping": 10位时间戳}
3. 订阅暗金 / 暗银
连接成功后发送订阅指令：
json
{"Key":"PAXG,PAXS,PAXGU,PAXSG"}
4. 注意事项
- 建议实现断线重连，应对网络波动
- 推送内容包含：最新价、开盘价、涨跌、盘口深度、分笔成交
三、HTTP 接口对接（简单易用）
1. 实时行情接口
地址：
plaintext
http://39.107.99.235:1008/getQuote.php?code=PAXG,PAXS
- 请求方式：GET
- 支持多品种逗号分隔，最多 50 个
- 建议请求头添加：
Accept-Encoding:gzip
2. K 线历史数据接口
地址示例：
plaintext
http://39.107.99.235:1008/redis.php?code=PAXG&time=1m&rows=100
支持周期：1m/5m/15m/30m/1h/1d/1M
四、常见报错与解决方案（重点）
报错 1：IP 未授权
返回示例：
plaintext
{"code":500,"msg":"您的IP未授权 xxx.xxx.xxx.xxx，请前往授权"}
原因：接口采用 IP 白名单机制，未授权无法访问。处理：前往平台授权页面添加服务器出口 IP。
报错 2：请求频率超限
原因：单品种每秒请求超过限制。处理：降低请求频率，使用 WebSocket 替代轮询。
报错 3：标的代码不存在
处理：检查标的是否为：PAXG、PAXS、PAXGU、PAXSG。
五、接口支持的全品类数据
除贵金属外，该套接口还可获取以下品类数据：
- 外汇
- 国际期货
- 国内期货
- 数字货币
- 国际股指期货
提供五类标准接口：
- WebSocket 实时推送
- HTTP 实时行情
- K 线历史数据
- 产品分类查询
- 产品订阅代码查询
返回结构统一，便于二次封装与系统集成。
六、适用开发场景
- 24 小时贵金属行情看板、网页 / 小程序 / APP 展示
- 量化交易策略数据来源
- 自动化盯盘、价格预警、风控系统
- 跨市场行情对比分析工具
- 企业级金融数据中台对接
七、开发最佳实践
- 优先使用 WebSocket，减少请求压力，延迟更低
- 必须处理 IP 未授权、断线、限流三类异常
- 批量查询时控制品种数量，避免触发限流
- 开启 gzip 压缩，提升传输效率
- 暗金 / 暗银为 24 小时品种，可长期保持连接
