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

# Market by Condition

> Get market metadata, token IDs, and outcomes by condition ID.

Returns full market metadata for a condition, including all token IDs and their outcome labels.

## Request

```
GET /v3/markets/condition/{condition_id}
```

### Path parameters

| Parameter      | Type   | Description                       |
| -------------- | ------ | --------------------------------- |
| `condition_id` | string | Market condition ID (0x-prefixed) |

## Example

```bash theme={null}
curl "https://api.polynode.dev/v3/markets/condition/0x6c4d221b3cf2c8d17467c70a8aa3c714e30299b6e57cd3e4269dc8a41d2b0cd8?key=YOUR_KEY"
```

```json theme={null}
{
  "data": [
    {
      "condition_id": "0x6c4d221b3cf2c8d17467c70a8aa3c714e30299b6e57cd3e4269dc8a41d2b0cd8",
      "question": "Will Trump pardon Joe Exotic \"The Tiger King\" in 2025?",
      "slug": "will-trump-pardon-joe-exotic-the-tiger-king-in-2025-784-928-365",
      "outcomes": ["Yes", "No"],
      "category": null,
      "active": true,
      "closed": true,
      "neg_risk": false,
      "volume_all_time": "99993.937724000003072433173656463623046875",
      "liquidity": "0",
      "end_date": "2025-12-31 12:00:00+00",
      "event_slug": "who-will-trump-pardon-in-2025",
      "event_title": "Who will Trump pardon in 2025?",
      "tag_slugs": ["Politics", "Trump", "SBF", "cz", "Trump Presidency", "Ghislaine Maxwell"],
      "token_ids": [
        "30698649476690694814108493145041085718609914990967907518412053225237708492787",
        "43362318061877762261164265810725209343672429810065542703856317173848260953021"
      ],
      "token_outcomes": ["Yes", "No"],
      "winning_outcome_index": 1
    }
  ],
  "rows_returned": 1,
  "has_more": false,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 3
}
```

The response is wrapped in the standard `data: [{...}]` envelope. If no condition matches, `data` is `[]` and `rows_returned` is `0`.

`volume_all_time` and `liquidity` are full-precision decimal strings — round on the client.

`token_ids` are decimal strings, not numbers — they are 78-digit values and lose precision if parsed as floats.

## Response fields (per row in `data`)

| Field                   | Type             | Nullable | Description                                                    |
| ----------------------- | ---------------- | -------- | -------------------------------------------------------------- |
| `condition_id`          | string           | no       | Market condition ID                                            |
| `question`              | string           | no       | Market question                                                |
| `slug`                  | string           | no       | URL slug                                                       |
| `outcomes`              | array\<string>   | no       | Outcome labels                                                 |
| `token_ids`             | array\<string>   | no       | Outcome token IDs (decimal-string-encoded)                     |
| `token_outcomes`        | array\<string>   | no       | Outcome label for each token, in the same order as `token_ids` |
| `active`                | boolean          | no       | Currently active                                               |
| `closed`                | boolean          | no       | No longer accepting orders                                     |
| `neg_risk`              | boolean          | no       | Multi-outcome (neg-risk) market                                |
| `volume_all_time`       | string (decimal) | no       | Full-precision volume in USD                                   |
| `liquidity`             | string (decimal) | no       | Full-precision current liquidity in USD                        |
| `end_date`              | string           | yes      | Market end date (Postgres timestamp with offset)               |
| `event_slug`            | string           | yes      | Parent event slug                                              |
| `event_title`           | string           | yes      | Parent event title                                             |
| `category`              | string           | yes      | Optional category label                                        |
| `tag_slugs`             | array\<string>   | yes      | Category tags in their canonical (Title Case) form             |
| `winning_outcome_index` | integer          | yes      | Which outcome won (null if unresolved)                         |