List markets

GET/api/v1/marketsPublic

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

A cross-partition query, so `minCursor` is not supported — passing it returns 400 rather than being silently ignored. Paginate with cursor (keyset) and pass the response's nextCursor back verbatim.

Query parameters

qstringqueryoptional
Keyword search (question text)
sortnewest | ending_soon | defaultqueryoptional
Sort order
Default"newest"Example"newest"
statusopen | resolved | paused | closed | allqueryoptional
Status filter
Default"all"Example"open"
tagstringqueryoptional
Filter by tag
seriesstringqueryoptional
Filter by event series
limitintegerqueryoptional
Page size (defaults to 20; the server caps it)
Default20Range≥ 1Example20
cursorstringqueryoptional
Keyset pagination cursor (the nextCursor from the previous page)
Example"c1:mkt-0001:184"

Response

200Page of markets

marketsobject(MarketSummary)[]
List of market summaries
marketIdstring
Engine market id
Example"mkt-0001"
slugstring
URL slug
Example"btc-above-120k-2026-12-31"
questionstring
Question text
Example"Will BTC clos…c 31, 2026?"
tickE4integer
Price tick (1e-4 USD), configurable per market
Example100
tradeableboolean
Whether the market currently accepts orders
Exampletrue
resolutionSourcestringnullable
Resolution data source
Example"pyth:BTC/USD"
cutoffTsint64
Matching cutoff (epoch seconds)
Example1760832000
underlyingCoinstringnullable
Underlying asset (BTC, for example)
Example"BTC"
winningOutcomeYES | NOnullable
Winning outcome; null = not resolved. "Resolved" is defined as this field being non-null
Example"YES"
resolvedAtSint64nullable
Unix seconds recorded by the resolution command (not the time the projection was written)
Example1760832060
disputeWindowEndsAtint64nullable
Dispute window end (epoch seconds); whether it has closed is for the client to derive against the current time
Example1760918400
engineStateREADY | OPEN | PAUSED | CLOSEDnullable
Engine-side lifecycle state; null = the record predates this field, so treat it as unknown
Example"READY"
onChainCutoffMsint64nullable
On-chain matching window (epoch milliseconds)
Example1760832000000
clarificationsobject[]
Clarifications
seriesIdstringnullable
The recurring event series this market belongs to
nextCursorstringnullable
Keyset cursor; null = there is no next page
Example"eyJhZnRlciI6I…dC0wMDIwIn0"

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

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

Response

Page of markets

{
  "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"
}

Query parameters

qstringqueryoptional
Keyword search (question text)
sortnewest | ending_soon | defaultqueryoptional
Sort order
Default"newest"Example"newest"
statusopen | resolved | paused | closed | allqueryoptional
Status filter
Default"all"Example"open"
tagstringqueryoptional
Filter by tag
seriesstringqueryoptional
Filter by event series
limitintegerqueryoptional
Page size (defaults to 20; the server caps it)
Default20Range≥ 1Example20
cursorstringqueryoptional
Keyset pagination cursor (the nextCursor from the previous page)
Example"c1:mkt-0001:184"

Response

200Page of markets

marketsobject(MarketSummary)[]
List of market summaries
marketIdstring
Engine market id
Example"mkt-0001"
slugstring
URL slug
Example"btc-above-120k-2026-12-31"
questionstring
Question text
Example"Will BTC clos…c 31, 2026?"
tickE4integer
Price tick (1e-4 USD), configurable per market
Example100
tradeableboolean
Whether the market currently accepts orders
Exampletrue
resolutionSourcestringnullable
Resolution data source
Example"pyth:BTC/USD"
cutoffTsint64
Matching cutoff (epoch seconds)
Example1760832000
underlyingCoinstringnullable
Underlying asset (BTC, for example)
Example"BTC"
winningOutcomeYES | NOnullable
Winning outcome; null = not resolved. "Resolved" is defined as this field being non-null
Example"YES"
resolvedAtSint64nullable
Unix seconds recorded by the resolution command (not the time the projection was written)
Example1760832060
disputeWindowEndsAtint64nullable
Dispute window end (epoch seconds); whether it has closed is for the client to derive against the current time
Example1760918400
engineStateREADY | OPEN | PAUSED | CLOSEDnullable
Engine-side lifecycle state; null = the record predates this field, so treat it as unknown
Example"READY"
onChainCutoffMsint64nullable
On-chain matching window (epoch milliseconds)
Example1760832000000
clarificationsobject[]
Clarifications
seriesIdstringnullable
The recurring event series this market belongs to
nextCursorstringnullable
Keyset cursor; null = there is no next page
Example"eyJhZnRlciI6I…dC0wMDIwIn0"

Switch status codes in the response example to view errors. For all codes, see the Errors page.