> For the complete documentation index, see [llms.txt](https://resolvedmarkets.com/llms.txt). Every docs page is also served as Markdown: append `.md` to its URL or send `Accept: text/markdown`.

# Get Market By Slug

### 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**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | yes | Market slug — full, partial, or with any timestamp |

**Query parameters**

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `format` | string | no | 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)). |

**Example response**

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