Polymarket: List Trades

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 one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

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

deepline tools execute polymarket_list_trades --input '{
  "limit": 100,
  "offset": 0,
  "takerOnly": true
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe 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.

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.

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).

Deepline cost

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

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation