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

# Polymarket: List Markets

> Listing or filtering markets by slug, tag, volume, dates, or closed status; use closed=true to read resolved outcomes. Polymarket List Markets reference.

Listing or filtering markets by slug, tag, volume, dates, or closed status; use closed=true to read resolved outcomes.

<Info>
  Tool ID: `polymarket_list_markets`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'polymarket_list_markets',
  {
    "limit": 123,
    "offset": 123,
    "order": "example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute polymarket_list_markets --input '{
  "limit": 123,
  "offset": 123,
  "order": "example"
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": [
    {
      "id": "id_123",
      "question": "example",
      "conditionId": "condition_123"
    }
  ]
}
```

Use `deepline tools get polymarket_list_markets --json` for the latest machine-readable contract.

## Input reference

List markets

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.limit` | `integer` | No | — | Minimum: 0. |
| `payload.offset` | `integer` | No | — | Minimum: 0. |
| `payload.order` | `string` | No | — | Comma-separated list of fields to order by |
| `payload.ascending` | `boolean` | No | — | — |
| `payload.id` | `array` | No | — | — |
| `payload.slug` | `array` | No | — | — |
| `payload.clob_token_ids` | `array` | No | — | — |
| `payload.condition_ids` | `array` | No | — | — |
| `payload.liquidity_num_min` | `number` | No | — | — |
| `payload.liquidity_num_max` | `number` | No | — | — |
| `payload.volume_num_min` | `number` | No | — | — |
| `payload.volume_num_max` | `number` | No | — | — |
| `payload.start_date_min` | `string` | No | — | Format: `date-time`. |
| `payload.start_date_max` | `string` | No | — | Format: `date-time`. |
| `payload.end_date_min` | `string` | No | — | Format: `date-time`. |
| `payload.end_date_max` | `string` | No | — | Format: `date-time`. |
| `payload.tag_id` | `integer` | No | — | — |
| `payload.related_tags` | `boolean` | No | — | — |
| `payload.cyom` | `boolean` | No | — | — |
| `payload.uma_resolution_status` | `string` | No | — | — |
| `payload.game_id` | `string` | No | — | — |
| `payload.sports_market_types` | `array` | No | — | — |
| `payload.rewards_min_size` | `number` | No | — | — |
| `payload.question_ids` | `array` | No | — | — |
| `payload.include_tag` | `boolean` | No | — | — |
| `payload.closed` | `boolean` | No | `false` | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "List markets",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 0
      },
      "offset": {
        "type": "integer",
        "minimum": 0
      },
      "order": {
        "type": "string",
        "description": "Comma-separated list of fields to order by"
      },
      "ascending": {
        "type": "boolean"
      },
      "id": {
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "slug": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "clob_token_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "condition_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "liquidity_num_min": {
        "type": "number"
      },
      "liquidity_num_max": {
        "type": "number"
      },
      "volume_num_min": {
        "type": "number"
      },
      "volume_num_max": {
        "type": "number"
      },
      "start_date_min": {
        "type": "string",
        "format": "date-time"
      },
      "start_date_max": {
        "type": "string",
        "format": "date-time"
      },
      "end_date_min": {
        "type": "string",
        "format": "date-time"
      },
      "end_date_max": {
        "type": "string",
        "format": "date-time"
      },
      "tag_id": {
        "type": "integer"
      },
      "related_tags": {
        "type": "boolean"
      },
      "cyom": {
        "type": "boolean"
      },
      "uma_resolution_status": {
        "type": "string"
      },
      "game_id": {
        "type": "string"
      },
      "sports_market_types": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "rewards_min_size": {
        "type": "number"
      },
      "question_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "include_tag": {
        "type": "boolean"
      },
      "closed": {
        "type": "boolean",
        "default": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `array` | Yes | — | Provider response payload. |
| `result.data[].id` | `string` | No | — | — |
| `result.data[].question` | `string \| null` | No | — | — |
| `result.data[].conditionId` | `string` | No | — | — |
| `result.data[].slug` | `string \| null` | No | — | — |
| `result.data[].twitterCardImage` | `string \| null` | No | — | — |
| `result.data[].resolutionSource` | `string \| null` | No | — | — |
| `result.data[].endDate` | `string \| null` | No | — | Format: `date-time`. |
| `result.data[].category` | `string \| null` | No | — | — |
| `result.data[].liquidity` | `string \| null` | No | — | — |
| `result.data[].sponsorName` | `string \| null` | No | — | — |
| `result.data[].sponsorImage` | `string \| null` | No | — | — |
| `result.data[].startDate` | `string \| null` | No | — | Format: `date-time`. |
| `result.data[].xAxisValue` | `string \| null` | No | — | — |
| `result.data[].yAxisValue` | `string \| null` | No | — | — |
| `result.data[].denominationToken` | `string \| null` | No | — | — |
| `result.data[].fee` | `string \| null` | No | — | — |
| `result.data[].image` | `string \| null` | No | — | — |
| `result.data[].icon` | `string \| null` | No | — | — |
| `result.data[].lowerBound` | `string \| null` | No | — | — |
| `result.data[].upperBound` | `string \| null` | No | — | — |
| `result.data[].description` | `string \| null` | No | — | — |
| `result.data[].outcomes` | `array \| null` | No | — | Polymarket sends this as a JSON-encoded string; the Deepline result returns the decoded array. |
| `result.data[].outcomePrices` | `array \| null` | No | — | Polymarket sends this as a JSON-encoded string; the Deepline result returns the decoded array. |
| `result.data[].volume` | `string \| null` | No | — | — |
| `result.data[].active` | `boolean \| null` | No | — | — |
| `result.data[].marketType` | `string \| null` | No | — | — |
| `result.data[].formatType` | `string \| null` | No | — | — |
| `result.data[].lowerBoundDate` | `string \| null` | No | — | — |
| `result.data[].upperBoundDate` | `string \| null` | No | — | — |
| `result.data[].closed` | `boolean \| null` | No | — | — |
| `result.data[].createdBy` | `integer \| null` | No | — | — |
| `result.data[].updatedBy` | `integer \| null` | No | — | — |
| `result.data[].createdAt` | `string \| null` | No | — | Format: `date-time`. |
| `result.data[].updatedAt` | `string \| null` | No | — | Format: `date-time`. |
| `result.data[].closedTime` | `string \| null` | No | — | — |
| `result.data[].wideFormat` | `boolean \| null` | No | — | — |
| `result.data[].new` | `boolean \| null` | No | — | — |
| `result.data[].mailchimpTag` | `string \| null` | No | — | — |
| `result.data[].featured` | `boolean \| null` | No | — | — |
| `result.data[].archived` | `boolean \| null` | No | — | — |
| `result.data[].resolvedBy` | `string \| null` | No | — | — |
| `result.data[].restricted` | `boolean \| null` | No | — | — |
| `result.data[].marketGroup` | `integer \| null` | No | — | — |
| `result.data[].groupItemTitle` | `string \| null` | No | — | — |
| `result.data[].groupItemThreshold` | `string \| null` | No | — | — |
| `result.data[].questionID` | `string \| null` | No | — | — |
| `result.data[].umaEndDate` | `string \| null` | No | — | — |
| `result.data[].enableOrderBook` | `boolean \| null` | No | — | — |
| `result.data[].orderPriceMinTickSize` | `number \| null` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

<Info>
  This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get polymarket_list_markets --json`.
</Info>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Polymarket provider guide](/docs/providers/polymarket/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.