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

# Markets

> Get market details and token information

Markets represent individual questions within an event. Each market has one or more outcomes (e.g., "Yes" / "No"), and each outcome has an associated token ID used in orderbook queries.

## List Markets

<ParamField path="GET" method="/markets">
  List all markets, ordered by 24-hour volume (descending, nulls last).
</ParamField>

### Query Parameters

<ParamField query="limit" type="integer" default="50">
  Results per page (1–500).
</ParamField>

<ParamField query="min24hVolume" type="number" default="0">
  Minimum 24-hour volume filter. Only markets with `volume_24h >= min24hVolume` are returned.
</ParamField>

<ParamField query="offset" type="integer">
  Offset for pagination. When provided, cursor parameters are ignored.
</ParamField>

<ParamField query="cursor_volume" type="number">
  Volume cursor for pagination (from `next` object).
</ParamField>

<ParamField query="cursor_id" type="integer">
  Market ID cursor for pagination (from `next` object).
</ParamField>

### Example

Get top markets by volume:

```bash theme={null}
curl "http://api.poly-data.xyz/markets?limit=5"
```

Get markets with at least \$10,000 daily volume:

```bash theme={null}
curl "http://api.poly-data.xyz/markets?min24hVolume=10000&limit=5"
```

Response:

```json theme={null}
{
  "limit": 5,
  "min24hVolume": 10000,
  "data": [
    {
      "id": 1034460,
      "event_id": 126261,
      "question": "Will Eintracht Frankfurt win on 2026-01-09?",
      "slug": "bun-ein-dor-2026-01-09-ein",
      "description": "...",
      "created_at": "2025-12-27T05:00:04.093Z",
      "start_date": "2025-12-27T05:13:00.407Z",
      "end_date": "2026-01-09T19:30:00.000Z",
      "deploying_timestamp": "2025-12-27T05:00:55.483Z",
      "active": true,
      "closed": false,
      "archived": false,
      "ready": false,
      "funded": false,
      "accepting_orders": true,
      "neg_risk": true,
      "volume_24h": "225160.59",
      "volume_total": "231175.94",
      "liquidity": "438058.03",
      "order_min_size": "5",
      "order_price_min_tick_size": "0.001"
    }
  ],
  "next": {
    "cursor_volume": 225160.59,
    "cursor_id": 1034460
  }
}
```

<Note>
  `cursor_volume` can be `null` for markets without 24-hour volume data.
</Note>

***

## Get Market

<ParamField path="GET" method="/markets/:id">
  Get a single market by its numeric ID, including embedded outcomes with token IDs.
</ParamField>

### Path Parameters

<ParamField path="id" type="integer" required>
  Market ID (numeric only).
</ParamField>

### Example

```bash theme={null}
curl "http://api.poly-data.xyz/markets/1034460"
```

Response:

```json theme={null}
{
  "id": "1034460",
  "event_id": "126261",
  "question": "Will Eintracht Frankfurt win on 2026-01-09?",
  "slug": "bun-ein-dor-2026-01-09-ein",
  "description": "In the upcoming game, scheduled for January 9, 2026\nIf Eintracht Frankfurt wins, this market will resolve to \"Yes\".\nOtherwise, this market will resolve to \"No\".",
  "created_at": "2025-12-27T05:00:04.093Z",
  "start_date": "2025-12-27T05:13:00.407Z",
  "end_date": "2026-01-09T19:30:00.000Z",
  "deploying_timestamp": "2025-12-27T05:00:55.483Z",
  "active": true,
  "closed": false,
  "archived": false,
  "ready": false,
  "funded": false,
  "accepting_orders": true,
  "neg_risk": true,
  "volume_24h": "225160.59007300003",
  "volume_total": "231175.940446",
  "liquidity": "438058.02695",
  "order_min_size": "5",
  "order_price_min_tick_size": "0.001",
  "outcomes": [
    {
      "id": 12771,
      "outcome_index": 0,
      "outcome": "Yes",
      "token_id": "113230976933674601135419276232321769865636781054804255103253100668166812267778"
    },
    {
      "id": 12772,
      "outcome_index": 1,
      "outcome": "No",
      "token_id": "114877335229422177970817804142795745566078153600519625559547182926779275233294"
    }
  ]
}
```

### Market Response Fields

| Field                       | Type    | Description                                       |
| --------------------------- | ------- | ------------------------------------------------- |
| `id`                        | string  | Market ID                                         |
| `event_id`                  | string  | Parent event ID                                   |
| `question`                  | string  | The market question                               |
| `slug`                      | string  | URL-safe slug                                     |
| `description`               | string  | Detailed market description                       |
| `created_at`                | string  | ISO 8601 creation timestamp                       |
| `start_date`                | string  | ISO 8601 start timestamp                          |
| `end_date`                  | string  | ISO 8601 end timestamp                            |
| `deploying_timestamp`       | string  | ISO 8601 deployment timestamp                     |
| `active`                    | boolean | Whether the market is active                      |
| `closed`                    | boolean | Whether the market is closed                      |
| `archived`                  | boolean | Whether the market is archived                    |
| `ready`                     | boolean | Whether the market is ready                       |
| `funded`                    | boolean | Whether the market is funded                      |
| `accepting_orders`          | boolean | Whether orders are currently accepted             |
| `neg_risk`                  | boolean | Negative risk flag                                |
| `volume_24h`                | string  | Trading volume in the last 24 hours               |
| `volume_total`              | string  | All-time trading volume                           |
| `liquidity`                 | string  | Current liquidity                                 |
| `order_min_size`            | string  | Minimum order size                                |
| `order_price_min_tick_size` | string  | Minimum price tick size                           |
| `outcomes`                  | array   | List of outcomes (only on single-market endpoint) |

### Outcome Object

| Field           | Type    | Description                                      |
| --------------- | ------- | ------------------------------------------------ |
| `id`            | integer | Outcome ID                                       |
| `outcome_index` | integer | Position index (0 = Yes, 1 = No)                 |
| `outcome`       | string  | Outcome name (e.g., "Yes", "No")                 |
| `token_id`      | string  | Token ID used in orderbook queries as `asset_id` |

<Tip>
  The `token_id` is what you'll use as the `asset_id` parameter when querying orderbooks for a specific outcome.
</Tip>