GET/v1/markets/by-slug/:slug

Get Market By Slug

Get a single market using its slug OR raw conditionId (0x…). Supports exact slugs, partial slugs (e.g. sol-updown-5m), and slugs with any timestamp. Closed markets resolve from durable metadata with their full identity (label, question, end_date, event_title, neg_risk_id); markets without a metadata row fall back to capture stats. Closed non-crypto responses omit crypto/crypto_price; live non-crypto responses carry crypto as an empty string. CAVEAT: looking up a currently-LIVE market by raw conditionId resolves via durable metadata and reports active:false/expired:true — use its slug (or /v1/markets/live) for accurate live-status flags.

Path Parameters

slugstringrequired

Market slug — full, partial, or with any timestamp

Query Parameters

formatstringdefault:json

Response encoding. csv and tsv return the rows as a flat file instead of a JSON envelope — the envelope moves to X-* response headers and nulls render as \N. REQUIRES SCALE OR ENTERPRISE (json is available on every tier). Works with includebook=true — the bids/asks ladders come through as compact JSON inside their cell, complete and parseable (pandas: df["bids"].apply(json.loads)).

Response

200401403404500

Successful Response

Code Snippet

curl -X GET "https://api.resolvedmarkets.com/v1/markets/by-slug/:slug" \
  -H "X-API-Key: YOUR_API_KEY"

200

{
  "market_id": "0x778be094...",
  "category": "crypto",
  "subcategory": "BTC",
  "label": "Bitcoin Up or Down - August 4, 6:25AM-6:30AM ET",
  "crypto": "BTC",
  "timeframe": "5m",
  "slug": "btc-updown-5m-...",
  "question": "Bitcoin Up or Down - August 4, 6:25AM-6:30AM ET",
  "token_ids": ["1234...", "5678..."],
  "outcomes": ["Up", "Down"],
  "token_id_up": "1234...",
  "token_id_down": "5678...",
  "end_date": "2026-08-04T10:30:00.000Z",
  "active": true,
  "expired": false,
  "expires_in": 234000
}