Markets overview

PredictStreet runs two market families, both resolved through the same oracle pipeline but with different on-chain settlement adapters.

Binary markets

YES / NO on a single question. Settled through CTFExchange against ConditionalTokens.

Neg-risk markets

3+ mutually exclusive outcomes. Settled through NegRiskAdapter

PredictStreetNegRiskCtfExchange.

Binary markets come in several verticals (sports, politics, crypto, …). Crypto markets are ordinary binary markets that carry two extra payload blocks describing the price rule they settle against:

Crypto markets

Price questions on BTC / ETH — the crypto rule block, the product catalog, and the underlying-price curve endpoint.

Up/Down windows

Short-dated Up / Down markets on a recurring window grid — the cryptoWindow block and series navigation.

Lifecycle

DRAFT → PROPOSED → PRE_MARKET → OPEN → PAUSED/SUSPENDED → RESOLVED/VOIDED/CANCELLED

See Market status for the full state machine.

Listing markets

GET /api/markets?status=OPEN&sort=kickoff&limit=50&offset=0
# Public — no auth required. Sending X-Api-Key raises your rate-limit ceiling.

The endpoint uses offset pagination:

Parameter	Default	Constraints	Meaning
`limit`	`50`	Integer from `1` to `500`	Maximum markets returned in this page.
`offset`	`0`	Non-negative integer	Number of matching markets to skip.
`sort`	`kickoff`	`kickoff`, `activity`, or `shares`	Ordering applied before `offset` and `limit`.
`status`	—	CSV of public market statuses	Explicit status filter; takes precedence over `closed`.
`closed`	`false`	`true`, `false`, `1`, or `0`	Select closed instead of tradeable markets when `status` is omitted.

Increment offset by limit for each page. A page containing fewer than limit markets is the last page. The response does not include total, hasMore, or nextOffset.

const limit = 50;
let offset = 0;

for (;;) {
  const url = new URL(`${BASE}/api/markets`);
  url.search = new URLSearchParams({
    status: "OPEN",
    sort: "kickoff",
    limit: String(limit),
    offset: String(offset),
  });

  const { markets } = await fetch(url).then((response) => response.json());
  consume(markets);

  if (markets.length < limit) break;
  offset += limit;
}

Response:

{
  "markets": [
    {
      "id": "78fe1d92-656c-4daf-af6c-c08baf7d6a1e",
      "eventId": "8e905d52-...",
      "symbol": "M1V1-RMA-MCI-959311",
      "slug": "real-madrid-vs-manchester-city-real-madrid-to-win-the-tie",
      "title": "Real Madrid (ESP) vs Manchester City (ENG) — UCL R16",
      "groupItemTitle": "Real Madrid to win the tie",
      "conditionId": "0xabc…",
      "questionId": "0xdef…",
      "yesTokenId": "12345678901234567890",
      "noTokenId": "98765432109876543210",
      "status": "OPEN",
      "currentReviewRound": 1,
      "outcomeCount": 2,
      "outcomeLabels": ["YES", "NO"],
      "initialFairValue": "0.500000",
      "initialOutcomePrices": ["0.520000", "0.480000"],
      "feeTakerBps": 140,
      "opensAt": "2026-04-23T16:00:00Z",
      "closesAt": "2026-04-30T13:30:00Z",
      "kickoff": "2026-04-30T15:48:31Z",
      "resolutionWindowHours": 24,
      "pausedAt": null,
      "resolvedAt": null,
      "payoutNumerators": null,
      "officialDataSource": "UEFA official aggregate",
      "sourceMatchId": "ucl-26-r16-rma-mci",
      "resolutionCriteria": "Settles to the team that advances on aggregate.",
      "negRiskEligible": false,
      "isNewMarketType": false,
      "createdAt": "2026-04-20T12:00:00Z",
      "updatedAt": "2026-04-20T12:00:00Z"
    }
  ]
}

Crypto markets carry two additional blocks on the same shape — crypto (the machine-readable price rule) and cryptoWindow (Up/Down window facts). Both are null on every non-crypto market, so a client that ignores them is unaffected. See Crypto markets.

Polymarket-equivalent fields

Field	Meaning
`slug`	Canonical URL-safe identifier — lowercased kebab-case derived from `event.slug` + `groupItemTitle` + `title`. Required path parameter for `GET /api/markets/{slug}` (see Breaking change below). `symbol` is the operator-facing identifier and is unchanged.
`groupItemTitle`	Per-market label inside a multi-market event accordion (`"Real Madrid"`, `"Liverpool"`, `"Draw"`). Equal to `title` for single-market events.
`initialOutcomePrices`	Per-outcome seed prices parallel to `outcomeLabels`. Polymarket calls this `outcomePrices`.

On-chain identifiers

conditionId / questionId are the bytes32 hex values from ConditionalTokens. yesTokenId / noTokenId are the ERC-1155 position ids you sign over in your EIP-712 Order typed data. All four are null until the market’s deployment is confirmed (status PRE_MARKET or beyond). For multi-outcome (neg-risk) markets noTokenId is null — each outcome is its own YES token managed by the NegRiskAdapter. Pull the per-outcome token ids from the on-chain adapter via the conditionId. See Events overview for how markets group under events and how to filter the public catalog.

Individual market detail

GET /api/markets/{slug}

Breaking change (2026-05-16) — root market lookup is now resolved by slug, not symbol. Sending a symbol returns 404 market_not_found. The list response above carries a slug field (canonical, URL-safe, derived from the parent event + title); pass that value here.The sub-resource paths (/orderbook, /trades, /ohlc, /traders below) still resolve by symbol — only the root market detail endpoint changed.

Same shape as the list item above. For the event metadata around the market (group, stage, teamA, teamB, tags, eventStartTime), call GET /api/events/{id} with the event id from the parent grouping (see the Events group in the API reference sidebar).

# Discover slugs from the list endpoint, then fetch detail by slug.
curl "$BASE/api/markets?status=OPEN" \
  | jq -r '.markets[] | "\(.symbol)\t\(.slug)"'

curl "$BASE/api/markets/real-madrid-vs-manchester-city-real-madrid-to-win-the-tie"

Orderbook snapshot

GET /api/markets/{symbol}/orderbook?outcome=0&depth=20

Sub-resource — still keyed by symbol. For live book updates, use the orderbook WebSocket channel — polling is rate-limited and latency-inferior.

Getting Started

Authentication

Vaults

Deposits

Trading

Events & Tags

Markets

Portfolio

Withdrawals

WebSocket

Settlement & Oracle

On-chain Contracts

Partners

Errors

Binary markets

Neg-risk markets

Crypto markets

Up/Down windows

Lifecycle

Listing markets

Polymarket-equivalent fields

On-chain identifiers

Individual market detail

Orderbook snapshot

Binary markets

Neg-risk markets

Crypto markets

Up/Down windows

​Lifecycle

​Listing markets

​Polymarket-equivalent fields

​On-chain identifiers

​Individual market detail

​Orderbook snapshot

Lifecycle

Listing markets

Polymarket-equivalent fields

On-chain identifiers

Individual market detail

Orderbook snapshot