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:
{ "name": "polymarket_trades", "params": { "marketId": "516710", "limit": 200, "minSize": 250 } }
By wallet:
{ "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