| Xlight API用户手册 v1.6.0.23 Xlight极速柜台接口文档

载入中...
搜索中...
未找到
行情API

# 行情API简介

行情API用于订阅并接收行情数据（如快照、逐笔等），以及进行相关查询。API采用异步回调模型，行情数据通过回调接口推送。

相关头文件：

- `xlt_api/xlt_quote/xlt_quote_api.h`
- `xlt_api/xlt_quote/xlt_quote_config.h`
- `xlt_api/xlt_quote/xlt_quote_struct.h`
- `xlt_api/xlt_quote/xlt_quote_define.h`
- `xlt_api/xlt_quote/xlt_quote_data_type.h`
- `xlt_api/xlt_quote/xlt_quote_list.h`
- `xlt_api/xlt_quote/decoder/`（如包含解码器相关定义）

行情API由以下三个核心部分组成：

组成 | 类 | 说明
--- | --- | ---
配置 | XLTQuoteConfig | 行情API配置结构，用于设置交易日、网卡地址、AGW地址等参数
接口 | XLTQuoteApi | 行情API入口类，负责初始化、登录、订阅/退订、查询、回补等
回调 | XLTQuoteSpi | 行情回调接口，包括登录响应、行情原始包推送、静态信息查询响应、逐笔回补推送等

可从以下入口查看接口与数据结构的完整定义：

- 文件列表（定位 `xlt_quote_api.h`）
- 类列表

## 配置说明（XLTQuoteConfig）

配置项 | 接口 | 说明 | 配置样例
--- | --- | --- | ---
交易日 | x1::XLTQuoteConfig::set_trading_day | 格式YYYYMMDD；生产环境通常为当前交易日，测试环境为柜台指定交易日 | `config.set_trading_day(20260402);`
本地网卡IP | x1::XLTQuoteConfig::set_local_addr | 设置连接AGW与行情接收的本地网卡IP（生产需为对应接入网段） | `config.set_local_addr("192.168.8.155", "192.168.3.155");`
AGW地址 | x1::XLTQuoteConfig::add_agw_addr | 添加一个AGW地址（可重复添加多个） | `config.add_agw_addr("192.168.5.64", 7060);`
是否使用Level2行情 | x1::XLTQuoteConfig::set_use_level2 | 设置是否使用Level2行情，默认不开启 | `config.set_use_level2(true)`

以下为进程级环境变量配置，通过系统环境变量设置。若同一进程中同时使用了交易API和行情API，则共用同一份环境变量。

环境变量 | 默认值 | 说明 | 配置样例
--- | --- | --- | ---
XLT_FILE_PATH | `.`（当前路径） | 文件存放路径（如日志文件）。若路径不存在，API将无法初始化 | `export XLT_FILE_PATH=/data/xlt`
XLT_LOG_LEVEL | INFO | 日志级别，可选值：FATAL / ERROR / WARN / INFO / DEBUG / TRACE | `export XLT_LOG_LEVEL=DEBUG`
XLT_REQUEST_TIMEOUT | 5 | 请求超时时间，单位秒 | `export XLT_REQUEST_TIMEOUT=10`

## 接口说明（XLTQuoteApi）

分类 | 接口 | 说明
--- | --- | ---
创建/基础信息 | x1::XLTQuoteApi::create |
| x1::XLTQuoteApi::get_api_version |
| x1::XLTQuoteApi::get_last_error |
| x1::XLTQuoteApi::get_trading_day |
初始化 | x1::XLTQuoteApi::initialize |
停止 | x1::XLTQuoteApi::stop | 停止回调，退出程序前调用，避免回调线程访问已销毁的对象
登录/登出 | x1::XLTQuoteApi::login |
| x1::XLTQuoteApi::logout |
订阅 | x1::XLTQuoteApi::subscribe_quote |
退订 | x1::XLTQuoteApi::unsubscribe_quote |
静态信息查询 | x1::XLTQuoteApi::query_static_quote_info |
Level1行情查询 | x1::XLTQuoteApi::query_level1_quote |
| x1::XLTQuoteApi::query_all_level1_quote |
回补（Level2逐笔） | x1::XLTQuoteApi::request_rebuild_tick_quote |

## 回调说明（XLTQuoteSpi）

类别 | 回调接口 | 说明
--- | --- | ---
连接/会话 | x1::XLTQuoteSpi::on_disconnect |
登录 | x1::XLTQuoteSpi::on_login |
行情推送 | x1::XLTQuoteSpi::on_quote |
静态信息查询 | x1::XLTQuoteSpi::on_query_static_quote_info |
Level1行情查询 | x1::XLTQuoteSpi::on_query_level1_quote |
| x1::XLTQuoteSpi::on_query_all_level1_quote |
回补 | x1::XLTQuoteSpi::on_request_rebuild_tick_quote_error |
| x1::XLTQuoteSpi::on_rebuild_tick_quote |

另请参阅：

- 行情API使用指南