> ## 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 Trades > Reading the executed trade tape for a market, event, or wallet, with size, price, and side. Includes inputs, outputs, SDK V2 examples, and Deepline cost. Reading the executed trade tape for a market, event, or wallet, with size, price, and side. Tool ID: `polymarket_list_trades` ## 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_trades', { "limit": 100, "offset": 0, "takerOnly": true }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute polymarket_list_trades --input '{ "limit": 100, "offset": 0, "takerOnly": true }' --json ``` ## Example response The static output schema is not detailed enough to generate a reliable example. Use `deepline tools get polymarket_list_trades --json` for the complete live contract. ## Input reference **Data API v2:** this route has a v2 counterpart, `GET /v2/trades`. See [Migrating to Data API v2](/docs/migrate/data-api-v1-to-v2). | Name | Type | Required | Default | Details | | - | - | - | - | - | | `payload.limit` | `integer` | No | `100` | Page size. Values above the maximum are clamped to 10000. Minimum: 0. Maximum: 10000. | | `payload.offset` | `integer` | No | `0` | Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 10000, page inside `start`/`end` windows — each window has its own offset budget. Minimum: 0. Maximum: 10000. | | `payload.takerOnly` | `boolean` | No | `true` | — | | `payload.filterType` | `"CASH" \| "TOKENS"` | No | — | Must be provided together with filterAmount. Allowed: `CASH`, `TOKENS`. | | `payload.filterAmount` | `number` | No | — | Must be provided together with filterType. Minimum: 0. | | `payload.market` | `array` | No | — | Comma-separated list of condition IDs. Mutually exclusive with eventId. | | `payload.eventId` | `array` | No | — | Comma-separated list of event IDs. Mutually exclusive with market. | | `payload.user` | `string` | No | — | User Profile Address (0x-prefixed, 40 hex chars) Pattern: `^0x[a-fA-F0-9]{40}$`. | | `payload.side` | `"BUY" \| "SELL"` | No | — | Allowed: `BUY`, `SELL`. | | `payload.start` | `integer` | No | — | Lower-bound timestamp (epoch seconds) for the trade window. Omit or pass `0` for the default window (most recent \~3 years); pass a positive epoch (e.g. `1`) to retrieve full history on user-scoped requests. Market/event-scoped requests keep the \~3-year floor — `start` can only narrow their window, not extend it. Minimum: 0. | | `payload.end` | `integer` | No | — | Upper-bound timestamp (epoch seconds) for the trade window. Omit for the default (current time); rows newer than `end` are excluded. Minimum: 0. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "**Data API v2:** this route has a v2 counterpart, `GET /v2/trades`. See [Migrating to Data API v2](/migrate/data-api-v1-to-v2).", "properties": { "limit": { "type": "integer", "description": "Page size. Values above the maximum are clamped to 10000.", "default": 100, "minimum": 0, "maximum": 10000 }, "offset": { "type": "integer", "description": "Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 10000, page inside `start`/`end` windows — each window has its own offset budget.", "default": 0, "minimum": 0, "maximum": 10000 }, "takerOnly": { "type": "boolean", "default": true }, "filterType": { "type": "string", "description": "Must be provided together with filterAmount.", "enum": [ "CASH", "TOKENS" ] }, "filterAmount": { "type": "number", "description": "Must be provided together with filterType.", "minimum": 0 }, "market": { "type": "array", "description": "Comma-separated list of condition IDs. Mutually exclusive with eventId.", "items": { "type": "string", "description": "0x-prefixed 64-hex string", "pattern": "^0x[a-fA-F0-9]{64}$" } }, "eventId": { "type": "array", "description": "Comma-separated list of event IDs. Mutually exclusive with market.", "items": { "type": "integer", "minimum": 1 } }, "user": { "type": "string", "description": "User Profile Address (0x-prefixed, 40 hex chars)", "pattern": "^0x[a-fA-F0-9]{40}$" }, "side": { "type": "string", "enum": [ "BUY", "SELL" ] }, "start": { "type": "integer", "description": "Lower-bound timestamp (epoch seconds) for the trade window. Omit or pass `0` for the default window (most recent ~3 years); pass a positive epoch (e.g. `1`) to retrieve full history on user-scoped requests. Market/event-scoped requests keep the ~3-year floor — `start` can only narrow their window, not extend it.", "minimum": 0 }, "end": { "type": "integer", "description": "Upper-bound timestamp (epoch seconds) for the trade window. Omit for the default (current time); rows newer than `end` are excluded.", "minimum": 0 } }, "required": [], "additionalProperties": false } ```
## Output reference Standard tool result payload. | Name | Type | Required | Default | Details | | - | - | - | - | - | | `result.data` | `array` | Yes | — | Provider response payload. | | `result.data[].proxyWallet` | `string` | No | — | User Profile Address (0x-prefixed, 40 hex chars) Pattern: `^0x[a-fA-F0-9]{40}$`. | | `result.data[].side` | `"BUY" \| "SELL"` | No | — | Allowed: `BUY`, `SELL`. | | `result.data[].asset` | `string` | No | — | — | | `result.data[].conditionId` | `string` | No | — | 0x-prefixed 64-hex string Pattern: `^0x[a-fA-F0-9]{64}$`. | | `result.data[].size` | `number` | No | — | — | | `result.data[].price` | `number` | No | — | — | | `result.data[].timestamp` | `integer` | No | — | Format: `int64`. | | `result.data[].title` | `string` | No | — | — | | `result.data[].slug` | `string` | No | — | — | | `result.data[].icon` | `string` | No | — | Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own. | | `result.data[].eventSlug` | `string` | No | — | — | | `result.data[].outcome` | `string` | No | — | — | | `result.data[].outcomeIndex` | `integer` | No | — | — | | `result.data[].name` | `string` | No | — | — | | `result.data[].pseudonym` | `string` | No | — | — | | `result.data[].bio` | `string` | No | — | — | | `result.data[].profileImage` | `string` | No | — | — | | `result.data[].profileImageOptimized` | `string` | No | — | — | | `result.data[].transactionHash` | `string` | No | — | — | | `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "description": "Standard tool result payload.", "properties": { "data": { "type": "array", "description": "Provider response payload.", "items": { "type": "object", "properties": { "proxyWallet": { "type": "string", "description": "User Profile Address (0x-prefixed, 40 hex chars)", "pattern": "^0x[a-fA-F0-9]{40}$" }, "side": { "type": "string", "enum": [ "BUY", "SELL" ] }, "asset": { "type": "string" }, "conditionId": { "type": "string", "description": "0x-prefixed 64-hex string", "pattern": "^0x[a-fA-F0-9]{64}$" }, "size": { "type": "number" }, "price": { "type": "number" }, "timestamp": { "type": "integer", "format": "int64" }, "title": { "type": "string" }, "slug": { "type": "string" }, "icon": { "type": "string", "description": "Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own." }, "eventSlug": { "type": "string" }, "outcome": { "type": "string" }, "outcomeIndex": { "type": "integer" }, "name": { "type": "string" }, "pseudonym": { "type": "string" }, "bio": { "type": "string" }, "profileImage": { "type": "string" }, "profileImageOptimized": { "type": "string" }, "transactionHash": { "type": "string" } }, "additionalProperties": false } }, "meta": { "type": "object", "description": "Additional response metadata (status, paging).", "additionalProperties": true } }, "required": [ "data" ], "additionalProperties": false } ```
## 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.