龙虾 OpenClaw 对接金融行情 API 完整接入教程

前言

目前量化开发者、数据分析爱好者普遍使用OpenClaw（龙虾）框架，快速对接各类金融行情接口，实现自动采集、实时监控、行情数据分析。** ****很多新手不知道龙虾如何对接标准 HTTP、WebSocket 行情接口**，也不清楚融通金、国际暗金、股票期货、外汇数字货币这类全品类数据怎么配置接入。

本文完全采用真实接口规范，所有开发者可直接照着配置使用。

一、行情接口基础信息

1. 基础域名地址

• 行情 HTTP 根地址：http://39.107.99.235:1008/market
• WebSocket 实时推送地址：ws://39.107.99.235/ws

2. 覆盖全品类数据接口

支持品类：沪深 A 股、美股、港股、台股、印股、国内期货、国际期货、股指期货、外汇、虚拟货币、比特币、以太坊、贵金属、融通金、国金暗金、黄金 9999、伦敦金、美原油、恒指期货。

3. 接口类型

1. WebSocket 实时行情推送接口
2. HTTP 获取实时行情接口
3. HTTP 获取 K 线图接口
4. HTTP 查询产品分类接口
5. HTTP 查询产品订阅代码接口

所有接口均为标准 HTTP / 通用 WebSocket 协议 ，原生兼容龙虾 OpenClaw，无需开发专属接口、无需适配改造。

二、前置接入条件

1. 对接前需将部署龙虾的服务器 IP完成授权，未授权无法正常请求数据。
2. HTTP 接口请求头必须携带 Accept-Encoding:gzip，提升响应速度、节省带宽。
3. 严格遵守接口请求频率限制，避免触发系统限流。
4. WebSocket 客户端需实现10 秒心跳、断线自动重连，龙虾可直接配置自带该能力。

四、龙虾配置 HTTP 行情接口实操

1. 常用 HTTP 真实接口地址

• 实时行情接口：http://39.107.99.235:1008/getQuote.php?code=品种代码
• K 线图接口：http://39.107.99.235:1008/redis.php?code=品种代码&time=周期&rows=条数
• 产品分类接口：http://39.107.99.235:1008/getCategory.php
• 产品订阅代码接口：http://39.107.99.235:1008/getSymbolList.php?category=分类ID&page=页码&pageSize=条数

2. 龙虾配置步骤

1. 新建 HTTP 请求技能，填入以上真实接口地址。
2. 请求头添加：Accept-Encoding: gzip。
3. 拼接 code 参数，支持多个品种英文逗号分隔，最大支持 50 个产品。
4. 遵循限流规则：单品种每秒最多请求 3 次，K 线接口单品种每秒最多 5 次。
5. 龙虾自动接收 JSON 返回数据，自动解析最新价、开盘价、高低价、涨跌额、涨跌幅、买卖盘深度等字段。

3. 适用场景

龙虾定时轮询采集实时行情、批量获取 K 线历史数据、自动整理产品分类与订阅代码，用于后续行情分析、策略回测、价格异动监控。

五、龙虾配置 WebSocket 实时行情接口实操

1. WebSocket 连接地址

ws://39.107.99.235/ws

2. 接口规范要点

1. 客户端每 10 秒发送一次心跳：{"ping":10位时间戳}，服务端返回 {"pong":时间戳}。
2. 连接成功后发送订阅指令：{"Key":"品种代码1,品种代码2"}。
3. 服务端主动实时推送行情、盘口深度、逐笔成交数据，K 线需单独调用 HTTP 接口。

3. 龙虾配置关键点

1. 在龙虾中新建 WebSocket 订阅技能，填写真实 ws 地址。
2. 配置定时任务，每 10 秒自动发送心跳报文。
3. 填入多品种订阅 JSON 格式，无需重复订阅同一产品。
4. 开启龙虾自带断线自动重连，网络中断后自动恢复连接。
5. 自动解析推送 JSON 数据，提取 StockCode、Price、Open、High、Low、DiffRate 等关键字段。

六、龙虾接入后可实现的数据分析能力

1. 全品种实时行情自动监控、价格异动预警。
2. 融通金、国际暗金、伦敦金、美原油等贵金属期货数据自动汇总。
3. 比特币、以太坊等虚拟货币行情实时采集与趋势分析。
4. 历史 K 线数据批量抓取，用于量化策略回测。
5. 自动统计涨跌幅度、成交量变化、盘口资金流向。
6. 无需手动写代码，依靠龙虾自然语言指令即可完成数据整理与分析。

七、接入常见避坑要点

1. WebSocket 不要重复订阅，避免浪费连接与带宽资源。
2. 务必开启 gzip 压缩，否则响应慢、流量消耗大。
3. 龙虾 WebSocket 必须配置 10 秒心跳，长时间无心跳会被服务端断开。

八、总结

1. 标准金融行情 HTTP、WebSocket 接口原生兼容龙虾 OpenClaw，无需单独开发适配接口。

2. 本文采用公开接口地址，开发者可直接照着在龙虾中配置，一键接入全品类行情数据。

3. 覆盖融通金、贵金属、股票、期货、外汇、数字货币等全部品类，适配量化分析、行情监控、自动化数据采集场景

   ---

   相关资源：

   官方文档和API参考：http://39.107.99.235:1008/market