ptrade 量化平台 get_individual_entrust 接口的 start_pos 和 search_direction 如何使用？

在 ptrade 量化交易平台中，get_individual_entrust 接口用于获取当日的逐笔委托行情数据。该接口中的 start_pos 和 search_direction 参数主要用于控制获取数据的起始点和时间顺序。

1. start_pos (起始位置)

• 含义：指定从哪一条数据开始获取。
• 类型：int
• 默认值：0
• 用法：当需要分页获取或跳过最新的几条数据时，可以设置此参数。例如，start_pos=0 表示从符合搜索方向的第一条数据开始获取；start_pos=50 表示跳过前50条数据，从第51条开始获取。

2. search_direction (搜索方向)

• 含义：指定获取数据的时间顺序方向。
• 类型：int
• 默认值：1
• 取值说明：
  • 1 (向前)：返回的数据时间顺序是从最新到最旧（倒序）。即列表中的第一条数据是距离当前时间最近的一笔委托。
  • 2 (向后)：返回的数据时间顺序是从旧到新（正序）。即列表中的第一条数据是当天最早的一笔委托（或基于 start_pos 的最早一笔）。

综合使用示例

假设你想获取某只股票最新的 50 条逐笔委托数据，并且希望数据按时间从最新到最旧排列：

entrust_data = get_individual_entrust(stocks=['600570.SS'], data_count=50, start_pos=0, search_direction=1, is_dict=True)

如果你想获取当天开盘后的前 50 条逐笔委托数据（从旧到新）：

entrust_data = get_individual_entrust(stocks=['600570.SS'], data_count=50, start_pos=0, search_direction=2, is_dict=True)

注意事项：

• 逐笔委托数据需要开通 Level-2 行情权限才能获取，否则会返回无数据。
• 建议将 is_dict 设置为 True，以字典格式返回数据，这样可以大幅提升数据获取和处理的速度。