> ## Documentation Index
> Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/markets/:id

> Full enriched detail on a single market.

Returns everything we know about one outcome: parsed metadata, current top-of-book quotes, lifetime stats, resolution info if resolved.

## Endpoint

```
GET /v1/markets/:id
```

The `:id` is the outcome\_id (integer).

## Response

```json theme={null}
{
  "outcome_id": 0,
  "title": "BTC >= $78213 by 2026-05-03 06:00 UTC (1d)",
  "name": "Recurring",
  "description_raw": "class:priceBinary|underlying:BTC|expiry:20260503-0600|targetPrice:78213|period:1d",
  "status": "active",
  "class": { "raw": "priceBinary", "label": "Binary outcome (Yes / No)", "description": "..." },
  "underlying": "BTC",
  "target_price": "78213",
  "period": { "raw": "1d", "label": "1 day", "description": "...", "applies_to": "86400" },
  "expiry": { "us": 1777788000000000, "iso": "2026-05-03T06:00:00+00:00", "relative": "in 12h" },
  "deployed_at": { "us": 1777727054207215, "iso": "...", "relative": "4h ago" },
  "resolved_at": null,
  "winning_side": null,
  "resolution_value": null,
  "question_id": null,
  "question_name": null,
  "sides": [
    {
      "side_index": 0, "label": "Yes",
      "coin": "#0", "asset_id": 100000000,
      "current_mid": "0.64832",
      "top_bid": "0.6478",
      "top_ask": "0.64882"
    },
    {
      "side_index": 1, "label": "No",
      "coin": "#1", "asset_id": 100000001,
      "current_mid": "0.35168",
      "top_bid": "0.35118",
      "top_ask": "0.3522"
    }
  ],
  "lifetime": {
    "fills": 26732,
    "unique_traders": 1299,
    "volume_usdh": "1147289.829980"
  }
}
```

| Field                 | Description                                                                     |
| --------------------- | ------------------------------------------------------------------------------- |
| `description_raw`     | Original pipe-encoded HL description string                                     |
| `top_bid` / `top_ask` | Best limit order resting in the book per side                                   |
| `winning_side`        | Index of the winning side (0 or 1) once resolved; `null` while active           |
| `resolution_value`    | Final value of the underlying at resolution (e.g. BTC price for a price binary) |

## 404

```
HTTP 404
{"error":"outcome 9999 not found"}
```

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl -H "X-API-Key: hip4_live_..." \
    https://hip4.polynode.dev/api/v1/markets/0
  ```
</CodeGroup>