---

name: tool-polymarket-trades description: Use the polymarket_trades tool to fetch and filter recent Polymarket trades (free Data API), optionally by market or wallet.

polymarket_trades (Polymarket trade tape)

When to use

• See recent trade flow for a specific market (or wallet).
• Detect whale activity (combine with minSize).

Parameters

• marketId (string, optional):
  • Gamma numeric id like "516710" or
  • conditionId hex like "0x..." (64 hex chars).
  • If numeric, the tool resolves it to conditionId via Gamma.
• user (string, optional): Wallet address (0x...) to filter trades.
• limit (int, optional, 1–500): Default 50.
• minSize (number, optional): Filters out trades smaller than this (USD size from API).

Examples

By market:

Copy{ "name": "polymarket_trades", "params": { "marketId": "516710", "limit": 200, "minSize": 250 } }

By wallet:

Copy{ "name": "polymarket_trades", "params": { "user": "0xabc123...", "limit": 100 } }

Output

• Returns: { marketId, conditionId, user, trades: Array<{ts,wallet,side,outcome,price,size,title,url,conditionId,tx}> }
• Rendered:
  • Meta (text: marketId/conditionId/user/trades count)
  • Trades (table: ts/side/outcome/price/size/wallet/title)

Notes

• If both user and marketId are provided, the API returns trades matching both filters.
• targetWindow: poly