美股swifttrade ppro8 api 行情交易接口文档 http+udp订阅

### 美股SwiftTrade PPro8 API 行情交易接口文档详解 #### 一、概览 本文档主要介绍了美股SwiftTrade PPro8 API的行情交易接口文档，特别是HTTP和UDP订阅方式的相关配置和使用方法。对于希望利用此API进行自动化交易或获取实时市场数据的开发人员来说，这份文档具有极高的参考价值。 #### 二、HTTP 接口配置与使用 ##### 1. 启动PProApi服务 - **启动服务**：为了能够使用PProApi的服务，首先需要确保服务已经正确启动。可以通过命令行参数`-pproapi_port=N`来指定端口号，其中`N`是你希望使用的端口号。 ```shell -pproapi_port=8080 ``` - **访问地址**：默认情况下，服务监听在`localhost`上，可以通过以下格式的URL来访问： ```plaintext http://localhost:[指定的端口号] ``` - **API版本**：当前文档所介绍的是PProApi v1.1版本。 ##### 2. 支持的命令及语法 - **Register**：用于注册特定的市场数据订阅。支持的参数包括： - `symbol`：股票代码，如`AAPL.NYSE`表示纽约证券交易所的苹果公司股票。 - `region`：可选值为`[1|2|3|4]`，代表不同的地理区域。 - `feedtype`：数据类型，包括`L1`（Level 1行情）、`TOS`（Top Of Book）、`L2`（Level 2行情）、`IMBALANCE`、`OSTAT`、`ORDEREVENT`、`PAPIORDER`等。 **示例**： ```plaintext http://localhost:8080/Register?symbol=AAPL.NYSE&feedtype=L1 ``` - **SetOutput**：设置输出方式。可以指定数据的输出格式以及是否开启输出。 - `output`：输出方式，支持`bykey`（按键输出）、`bytype`（按类型输出）以及通过指定端口输出（如`4134`）。 - `status`：输出状态，支持`on`或`off`。 **示例**： ```plaintext http://localhost:8080/SetOutput?symbol=AAPL.NYSE&feedtype=L1&output=bykey&status=on ``` - **GetSnapshot**：获取快照数据，即某一时刻的市场数据快照。 - `symbol`：股票代码。 **示例**： ```plaintext http://localhost:8080/GetSnapshot?symbol=AAPL.NYSE ``` ##### 3. 注意事项 - 对于`IMBALANCE`、`OSTAT`、`ORDEREVENT`、`PAPIORDER`这类消息，需要传递`region`参数。 - 对于`L1`、`L2`或`TOS`数据，必须传递`symbol`参数。 - `'Lv1'`和`'Tos'`已被标记为废弃但仍可用，建议更新脚本以使用`TOS`或`L1`。 #### 三、UDP 订阅 除了HTTP接口外，文档还提到了通过UDP协议订阅市场数据的方式。这种方式适用于需要高速数据传输的应用场景。 - **输出到UDP端口**：通过将`output`参数设置为一个端口号（例如`4134`），可以将数据广播到本地主机的UDP端口上。 **示例**： ```plaintext http://localhost:8080/SetOutput?symbol=AAPL.NYSE&feedtype=L1&output=4134&status=on ``` #### 四、其他功能与注意事项 - **数据文件生成**：启用`L1`数据订阅时，还会自动生成以下类型的文件： - `InstrumentUpdate (IU_*)` - `SummaryUpdate (SU_*)` - `AlertMessages (AM_*)` - `AuctionInfo (AI_*)` #### 五、总结 美股SwiftTrade PPro8 API提供了丰富的行情交易接口，通过HTTP和UDP订阅方式，用户可以灵活地获取实时市场数据并进行自动化交易。本文档详细介绍了如何启动服务、注册订阅、设置输出方式等操作，以及需要注意的细节问题。希望本文能帮助开发者更好地理解和使用该API，实现高效的数据获取和交易策略实施。