分页与查询范围
分页 count 是当前响应的事件条数,不提供全部匹配事件总数。返回的 pagination_key 是用于相同筛选和排序的不透明续页引用,不是页码或事件标识。已移除 offset 分页,仅接受 offset 为 0。某页返回条数可以少于请求上限。
普通第一页不要求选择条件。可选 status 使用 open 或 closed,search 匹配事件标题且长度为 3–100 个字符;id、slug、tag 各接受最多 50 个字符串。分类采用来源词汇。sort 默认为 created,但并未完整说明每种排序的方向、同值顺序及筛选组合规则。事件 limit 为 1–100 的整数,默认 20。
子市场与事件统计
内嵌子市场需 include_markets=true,默认为 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 仍是来源数据,未明确币种、概率、互补关系或结算公式。
此游标分页及筛选规则见官方事件文档。需要连接智能体时,请按Toolmu 连接指南完成设置。