E EventMatch

使用说明

以下为匹配能力与接口形态说明。账户注册、API Key、套餐与付费等入口将在后续版本开放。

RESTful API

适合自有后端、脚本、数据管道或任意能发 HTTPS 的系统直接调用。接口字段与行为与同仓 PolyLens 参考服务一致，具体见下文端点与示例。

接口说明

下列为 POST /api/news-polymatch/match 的请求与响应形态；自建或与公网能力对齐时均可参考。正式环境的专属 Base URL、调用鉴权与计费规则以后续站内说明为准。

端点

  • 方法：POST
  • 路径：/api/news-polymatch/match（PolyLens 参考实现仍注册旧路径 /api/news-polymatch/preview，行为相同，新集成请用 /match）
  • 完整 URL：{Base URL}/api/news-polymatch/match

请求头

  • Content-Type: application/json

请求体（JSON）

单次响应至多 10 个事件；data.count 与 events 长度为实际条数，可能少于 10。匹配依赖当前可召回的 Polymarket 候选与规则/模型打分阈值：不保证每次输入都能找到事件；若无一达到相关度要求，返回可为空列表（count 为 0），一般仍属 HTTP 200 成功响应，而非报错。

{
  "input": "关键词、https:// 资讯链接或整段正文"
}
  • input：必填，去首尾空白后非空；可为一句话、链接或正文。

成功响应

HTTP 200，JSON 信封含 code、message、data。data 含 events、count。

{
  "code": 200,
  "message": "ok",
  "data": {
    "events": [ /* 见下表 */ ],
    "count": 0
  }
}

data.events 为对象数组。单条事件常用字段如下（与 PolyLens EventClueRelatedEventResp 序列化一致；空值字段可能省略）：

JSON 字段 说明
market_idPolymarket / Gamma 市场标识
event事件标题（多为英文问句式，与官网列表一致）
event_desc事件描述
event_link官方入口链接
end_date截止时间
prediction_option第 1 档结果名（常见 Yes）
price第 1 档价格
odds第 1 档赔率
prediction_option_2第 2 档（常见 No）；单价场可能省略
price_2第 2 档价格
odds_2第 2 档赔率
match_score综合关联分 0–100
topic_relevance_score主题相关分 0–100
time_relevance_score时效相关分 0–100
strength_level关联强度，如 high / medium / low
active是否仍在交易中
closed是否已关闭
market_title兼容字段，多与标题类信息对齐
liquidity / volume流动性、成交量（若有）

错误响应

参数非法或服务异常时可能返回 HTTP 400 / 500，正文仍多为 JSON，含 code、message。

超时与性能

单轮请求可能需拉取 Gamma 候选池并跑规则/大模型排序，耗时从数几秒到数十秒不等；客户端、反向代理请配置合理的超时时间，避免过早断开。

调用示例（curl）

BASE="https://api.matchnext.one"
curl -sS -X POST "${BASE}/api/news-polymatch/match" \
  -H "Content-Type: application/json" \
  -d '{"input":"中东地缘与原油价格"}'

文档与更新

接口字段若有增删以发布说明为准。