auto_trade_sys/docs/common/行情接口可用性说明.md
薇薇安 13a0e7d580 delete: 移除过时的文档与代码文件
删除了多个不再使用的文档和代码文件,包括交易更新推送、条件订单推送、REST API 文档、WebSocket API 文档及相关的策略分析文档。这些文件的移除有助于清理代码库,确保项目的整洁性与可维护性。
2026-02-20 17:49:00 +08:00

62 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 行情接口可用性说明
基于「行情 WS 接口」「行情接口REST.txt」与当前交易系统实现对各类接口的**是否已用、是否建议用**做简要说明。
**已接入 REST**:深度、最新标记价格与资金费率、资金费率历史、未平仓合约数、持仓量历史、大户/全局多空比、主动买卖量(见 `binance_client.py`)。
---
## 一、当前系统已在用的
| 文档名称 | 在系统中的用法 |
|---------|----------------|
| **24hr 价格变动情况** | `ticker_24h_stream` WS + REST `get_ticker_24h` / `get_all_tickers_24h`,用于扫描涨跌幅、当前价、成交量。 |
| **K 线数据** | `kline_stream` WS + REST `get_klines`用于技术指标RSI/MACD/ATR/EMA 等)与多周期分析。 |
| **当前最优挂单** | `book_ticker_stream` WS!bookTicker+ 兜底 REST用于当前价、滑点估算、挂保护单前价格校验。 |
| **最新价格**(含 V2 | 功能被 24h ticker 与 book 覆盖,未单独接;需要“仅最新价”时可用 `ticker.price` 做轻量兜底。 |
---
## 二、建议接入、能明显改善的
| 文档名称 | 建议用途 | 说明 |
|---------|----------|------|
| **深度信息 (depth)** | 滑点估算、限价挂单参考、大单/盘口结构 | 目前只有最优买卖一档book接入 depth 后可做更准的市价冲击成本、或简单 order book 策略。可用 WS depth 流维护本地盘口,减少 REST 权重。 |
| **最新标记价格和资金费率** | 强平/风险展示、资金费成本 | 当前 markPrice 来自持仓接口;若要做「全市场标记价」或单独展示资金费率,可接此接口。资金费可用于过滤高费率时开仓。 |
| **标记价格 K 线数据** | 以标记价做技术分析 | 若希望指标更贴近强平价、减少插针影响可部分替代「K 线数据」用于计算。 |
| **查询资金费率历史 / 资金费率信息** | 资金费择时、多空成本 | 避免在资金费极高时开仓,或作为多空情绪/结构的辅助。 |
| **获取未平仓合约数 / 合约持仓量历史** | 量价、趋势过滤 | 与价格/成交量结合,做趋势确认或过滤(如持仓量骤增+价格突破)。 |
| **大户持仓量多空比 / 大户账户数多空比 / 多空持仓人数比** | 情绪/反向指标 | 可作为过滤条件或信号权重(例如极端多空比时谨慎同向开仓)。 |
| **合约主动买卖量** | 买卖压力、入场时机 | 辅助判断多空力量,用于入场/出场或过滤。 |
---
## 三、可选、按策略需要再接
| 文档名称 | 可选用途 |
|---------|----------|
| **近期成交 / 近期成交(归集) / 查询历史成交** | 微观结构、大单检测、成交分布统计;当前策略未用。 |
| **连续合约 K 线数据** | 跨期或连续合约分析时用。 |
| **价格指数 K 线 / 溢价指数 K 线** | 套利、基差、溢价策略。 |
| **基差 / 综合指数 / 多资产模式资产汇率指数 / 查询指数价格成分** | 指数、多腿或套利类策略。 |
| **查询保险基金余额 / 自动减仓风险评级** | 风控展示、极端行情监控。 |
| **一周交易时段** | 若要做「仅在某交易时段内交易」的规则时可接。 |
| **RPI 深度信息** | 文档注明响应不包含 RPI 订单;若不涉及 RPI 订单可忽略。 |
| **季度合约历史结算价** | 仅做季度合约或结算相关逻辑时需要。 |
---
## 四、落地优先级建议(结合当前项目)
1. **优先**
- **深度 (depth)**:用 WS depth 做本地盘口,提升滑点估算与限价参考,减少对单一 book 的依赖。
- **最新标记价格和资金费率**:若前端/风控要展示「标记价、资金费率」或按资金费过滤开仓,再接即可。
2. **其次**
- **资金费率历史/信息**、**未平仓合约数/持仓量历史**:用于过滤或信号增强。
- **大户多空比 / 主动买卖量**:作为可选过滤或权重,不改变主流程。
3. **按需**
- 标记价格 K 线、连续合约 K 线、溢价/指数类、保险基金/自动减仓、交易时段等,在明确产品需求(如套利、风控大屏、时段规则)后再接。
如果你愿意,我可以按「深度 + 标记价/资金费率」先给出具体接入方案WS 订阅方式、数据结构、在现有 `binance_client` / `position_manager` 里怎么用)。