市场列表

GET/api/v1/markets公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

跨分区查询，不支持 `minCursor`——传了直接 400，不是静默忽略。分页用 cursor(keyset)，响应 nextCursor 原样带回。

查询参数

qstringquery可选
关键词搜索（问题文本）
sortnewest | ending_soon | defaultquery可选
排序方式
默认"newest"示例"newest"
statusopen | resolved | paused | closed | allquery可选
状态过滤
默认"all"示例"open"
tagstringquery可选
按标签过滤
seriesstringquery可选
按事件系列过滤
limitintegerquery可选
每页条数（默认 20，有服务端上限）
默认20范围≥ 1示例20
cursorstringquery可选
keyset 分页游标（上一页响应的 nextCursor）
示例"c1:mkt-0001:184"

响应

200市场分页

marketsobject(MarketSummary)[]
市场摘要列表
marketIdstring
引擎市场 id
示例"mkt-0001"
slugstring
URL 标识
示例"btc-above-120k-2026-12-31"
questionstring
问题文案
示例"Will BTC clos…c 31, 2026?"
tickE4integer
价格档位（1e-4 USD）,per-market 可配置
示例100
tradeableboolean
当前是否可下单
示例true
resolutionSourcestring可为空
裁决数据源
示例"pyth:BTC/USD"
cutoffTsint64
撮合截止（epoch 秒）
示例1760832000
underlyingCoinstring可为空
底层币种（如 BTC）
示例"BTC"
winningOutcomeYES | NO可为空
裁决赢方；null = 未裁决。「已裁决」的判据就是它非空
示例"YES"
resolvedAtSint64可为空
裁决命令固化的 Unix 秒（非投影落库时间）
示例1760832060
disputeWindowEndsAtint64可为空
争议窗口结束（epoch 秒）；是否已结束由客户端与当前时间比较
示例1760918400
engineStateREADY | OPEN | PAUSED | CLOSED可为空
引擎侧生命周期；null = 迁移记录早于本字段，按未知处理
示例"READY"
onChainCutoffMsint64可为空
链上撮合窗口（epoch 毫秒）
示例1760832000000
clarificationsobject[]
澄清记录
seriesIdstring可为空
所属周期性事件系列
nextCursorstring可为空
keyset 游标；null = 没有下一页
示例"eyJhZnRlciI6I…dC0wMDIwIn0"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/markets?sort=newest&status=all&limit=20"

响应

市场分页

{
  "markets": [
    {
      "marketId": "mkt-0001",
      "slug": "btc-above-120k-2026-12-31",
      "question": "Will BTC close above $120,000 on Dec 31, 2026?",
      "tickE4": 100,
      "tradeable": true,
      "resolutionSource": "pyth:BTC/USD",
      "cutoffTs": 1760832000,
      "underlyingCoin": "BTC",
      "winningOutcome": "YES",
      "resolvedAtS": 1760832060,
      "disputeWindowEndsAt": 1760918400,
      "engineState": "READY",
      "onChainCutoffMs": 1760832000000,
      "clarifications": [],
      "seriesId": null
    }
  ],
  "nextCursor": "eyJhZnRlciI6Im1rdC0wMDIwIn0"
}

查询参数

qstringquery可选
关键词搜索（问题文本）
sortnewest | ending_soon | defaultquery可选
排序方式
默认"newest"示例"newest"
statusopen | resolved | paused | closed | allquery可选
状态过滤
默认"all"示例"open"
tagstringquery可选
按标签过滤
seriesstringquery可选
按事件系列过滤
limitintegerquery可选
每页条数（默认 20，有服务端上限）
默认20范围≥ 1示例20
cursorstringquery可选
keyset 分页游标（上一页响应的 nextCursor）
示例"c1:mkt-0001:184"

响应

200市场分页

marketsobject(MarketSummary)[]
市场摘要列表
marketIdstring
引擎市场 id
示例"mkt-0001"
slugstring
URL 标识
示例"btc-above-120k-2026-12-31"
questionstring
问题文案
示例"Will BTC clos…c 31, 2026?"
tickE4integer
价格档位（1e-4 USD）,per-market 可配置
示例100
tradeableboolean
当前是否可下单
示例true
resolutionSourcestring可为空
裁决数据源
示例"pyth:BTC/USD"
cutoffTsint64
撮合截止（epoch 秒）
示例1760832000
underlyingCoinstring可为空
底层币种（如 BTC）
示例"BTC"
winningOutcomeYES | NO可为空
裁决赢方；null = 未裁决。「已裁决」的判据就是它非空
示例"YES"
resolvedAtSint64可为空
裁决命令固化的 Unix 秒（非投影落库时间）
示例1760832060
disputeWindowEndsAtint64可为空
争议窗口结束（epoch 秒）；是否已结束由客户端与当前时间比较
示例1760918400
engineStateREADY | OPEN | PAUSED | CLOSED可为空
引擎侧生命周期；null = 迁移记录早于本字段，按未知处理
示例"READY"
onChainCutoffMsint64可为空
链上撮合窗口（epoch 毫秒）
示例1760832000000
clarificationsobject[]
澄清记录
seriesIdstring可为空
所属周期性事件系列
nextCursorstring可为空
keyset 游标；null = 没有下一页
示例"eyJhZnRlciI6I…dC0wMDIwIn0"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。