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

2 or more mutually exclusive outcomes. Settled through NegRiskAdapter

NegRiskCtfExchange.

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 and market-data questions on BTC, ETH and other crypto instruments — 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

PRE_MARKET → OPEN → CLOSED → PENDING_RESOLUTION → RESOLVED

Trading can be halted along the way (PAUSED, SUSPENDED, POSTPONED), and a market can be VOIDED from any status up to DISPUTED. 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. 600 requests / 60 s per client IP; an API key does not raise it.

The endpoint uses offset pagination:

Parameter	Default	Constraints	Meaning
`limit`	`50`	Integer from `1` to `500`	Maximum markets returned in this page.
`offset`	`0`	Integer from `0` to `1000000`	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. The response carries hasMore — true while a further page exists — but no total or nextOffset. With sort=activity or sort=shares on the default list, closed=true or status=OPEN, the order is recomputed about every 15 seconds, and pages read within that interval are usually cut from the same ordering, so a quick walk rarely repeats a market. A row’s tradeCount / totalShares can be a few seconds newer than its position. On any walk, a market that changes status between two pages drops out and moves the later rows up by one, so the row after it can be missed: de-duplicate by symbol.

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, hasMore } = await fetch(url).then((response) => response.json());
  consume(markets);

  if (!hasMore) 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"],
      "outcomePrices": ["0.550000", "0.510000"],
      "chances": ["0.520000", "0.480000"],
      "feeTakerBps": 140,
      "kickoff": "2026-04-30T15:48:31Z",
      "tradingWindow": {
        "preMarketStartsAt": "2026-04-23T12:00:00Z",
        "opensAt": "2026-04-23T16:00:00Z",
        "closesAt": "2026-04-30T13:30:00Z"
      },
      "resolutionWindowHours": 24,
      "lifecycle": {
        "closedAt": null,
        "pausedAt": null,
        "resolvedAt": null,
        "voidedAt": 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"
    }
  ],
  "hasMore": false
}

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`. The canonical path parameter for `GET /api/markets/{slug}` (see Individual market detail below). `symbol` is the operator-facing identifier and is unchanged.
`groupItemTitle`	Per-market label inside a multi-market event accordion (`"Real Madrid"`, `"Liverpool"`, `"Draw"`). `null` when not set — typically on standalone markets; fall back to `title`.
`outcomePrices`	Current cost to buy each outcome, parallel to `outcomeLabels`: the best ask, else the last trade, else `null`.
`chances`	Implied probability of each outcome, parallel to `outcomeLabels`: the book midpoint when the book is two-sided and the spread is at most 0.10, else the last trade; `1 / outcomeCount` before any trade. Never `null`.

Market types

marketType is the canonical bet type of a market — a closed enum, or null. It is the same value on GET /api/markets, on the markets[] embedded in GET /api/events, and on GET /api/me/positions. Three rules before you branch on it:

null is normal, not an error. Manual and legacy markets — including some older crypto Up/Down windows — carry no type. Treat null as “uncategorised”. To detect a crypto market, branch on the crypto block being non-null, never on marketType — see Crypto markets.
The set grows. New sports and bet types are added over time. Map unknown values to a generic “other” bucket rather than rejecting the market.
It is display and categorisation only. Settlement reads the provider criteria independently, so the type never changes how a market resolves.

The values, grouped by what they describe — the full set the API returns today:

Group	Values
Match outcome	`MATCH_WINNER`, `MATCH_WINNER_AET`, `DOUBLE_CHANCE`, `DRAW_NO_BET`, `HALF_TIME_RESULT`, `HT_FT`
Football lines & props	`TOTAL_GOALS`, `ASIAN_HANDICAP`, `BTTS`, `WIN_TO_NIL`, `ODD_EVEN_GOALS`, `CORRECT_SCORE`, `EXACT_GOALS_HOME`, `EXACT_GOALS_AWAY`, `PLAYER_ANYTIME_GOAL`, `PLAYER_FIRST_SCORER`, `PLAYER_ASSIST`, `DISCIPLINE_RED_CARD`, `DISCIPLINE_PENALTY`, `SQUAD_SELECTION`, `MATCH_PARTICIPATION`
Tournament & futures	`TOURNAMENT_WINNER`, `TOURNAMENT_REACH_STAGE`, `TOURNAMENT_AWARD`, `TOURNAMENT_PLAYER_APPEARS`, `GROUP_WINNER`, `GROUP_QUALIFICATION`
Tennis	`TENNIS_SET_WINNER`, `TENNIS_TOTAL_SETS`, `TENNIS_SETS_HANDICAP`, `TENNIS_TOTAL_GAMES`
Baseball	`BASEBALL_TOTAL_RUNS`, `BASEBALL_RUN_LINE`, `BASEBALL_F5_WINNER`, `BASEBALL_F5_TOTAL_RUNS`, `BASEBALL_F5_RUN_LINE`, `BASEBALL_EXTRA_INNINGS`, `BASEBALL_NRFI`
American football	`AMFOOTBALL_TOTAL_POINTS`, `AMFOOTBALL_SPREAD`
Basketball	`BASKETBALL_SPREAD`, `BASKETBALL_TOTAL_POINTS`
Ice hockey	`HOCKEY_PUCK_LINE`, `HOCKEY_TOTAL_GOALS`
Boxing & MMA	`BOXING_TO_GO_DISTANCE`, `BOXING_TOTAL_ROUNDS`, `BOXING_METHOD`, `MMA_TOTAL_ROUNDS`, `MMA_METHOD`
Cricket	`CRICKET_TEAM_TOTAL_RUNS`
Esports	`ESPORTS_MAP_WINNER`, `ESPORTS_TOTAL_MAPS`, `ESPORTS_MAP_HANDICAP`
Golf	`GOLF_WINNER`, `GOLF_EVENT`
Motorsport	`MOTORSPORT_RACE_WINNER`, `MOTORSPORT_POLE_POSITION`
Politics & general questions	`POLITICS_EVENT`, `POLITICS_WINNER`, `QUESTION_EVENT`, `QUESTION_WINNER`
Crypto	`CRYPTO_PRICE_EVENT` — every crypto market, Up/Down windows included (some older windows carry `null`)

A market’s moneyline reuses the generic outcome type regardless of sport: a baseball, boxing or American-football winner market is MATCH_WINNER, not a sport-prefixed value. Only the sport-specific lines and props carry a prefix.

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). A neg-risk group is a set of sibling markets, each a YES/NO market on one outcome of the group. Each sibling carries its own yesTokenId / noTokenId once deployed, and the same ids appear in outcomes[] (outcomeIndex 0 = YES, 1 = NO). See Neg-risk markets. See Events overview for how markets group under events and how to filter the public catalog.

Individual market detail

GET /api/markets/{slug}

Keyed by slug (since 2026-05-16) — the root market lookup takes the canonical slug. The list response above carries a slug field (canonical, URL-safe, derived from the parent event + title); pass that value here. A market symbol is still accepted as a fallback when no market has that slug, but the slug is the canonical key.The sub-resource paths (/orderbook, /trades, /ohlc, /traders below) resolve by symbol.

Same shape as the list item above. For the event metadata around the market (match, teamA, teamB, competition, tags, scheduledAt), call GET /api/events/{slug} with the event slug from the parent grouping (see Events overview).

# 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 token_book WebSocket channel — polling is rate-limited and latency-inferior. See Orderbook.

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

Market types

On-chain identifiers

Individual market detail

Orderbook snapshot

Binary markets

Neg-risk markets

Crypto markets

Up/Down windows

​Lifecycle

​Listing markets

​Polymarket-equivalent fields

​Market types

​On-chain identifiers

​Individual market detail

​Orderbook snapshot

Lifecycle

Listing markets

Polymarket-equivalent fields

Market types

On-chain identifiers

Individual market detail

Orderbook snapshot