选择事件范围
search 用于查询事件标题,长度为 3–100 个字符。已知事件也可通过 id 或 slug 选择,tag 则使用标签短标识。这三种条件都接受最多 50 个字符串的列表;分类名称采用来源词汇。条件组合规则,以及每种排序的方向或同值顺序,并未全部明确,不应以猜测替代用户要求。
子市场列表需要主动开启:include_markets 默认为 false。开启后,markets_per_event 为 1–50 的整数,默认 10。来源说明子集按交易量排序,但未明确其交易量时间范围或排序方向。受数量上限限制的列表可能少于 market_count;null 表示未提供内嵌列表,不等于该事件没有关联市场。
阅读事件数值与时间
min_volume 筛选事件近 7 天的美元交易量,min_open_interest 筛选当前事件的美元未平仓规模,两者均为非负阈值。它们应与 total_volume_usd、liquidity_usd 分别阅读。事件 rolling_metrics 和 series 对象提供补充原始上下文;系列统计属于另一范围,未确认事件整体刷新频率或数值归一化公式。
事件日期字段为可为空的 ISO 8601 时间。应分别保留 start_date、end_date、creation_date、closed_time,包括看起来不符合预期的值。事件状态或结束时间本身不能确认子市场状态或最终结果。如果附带子市场结果选项,应保留其标签、标识、可为空的价格和 winning_side 原值;此处未明确价格币种、概率含义或结算公式。
分页范围与资料
事件 limit 为 1–100 的整数,默认 20。分页 count 表示当前响应的事件条数,不返回匹配事件总数。pagination_key 是用于相同筛选和排序的不透明续页引用,不是事件标识。已不支持正数 offset。本页事件数、事件 market_count 和受上限限制的子市场列表长度是不同概念。
具体筛选项和可选子市场结构见官方事件文档。需要连接智能体时,请使用Toolmu 连接指南。