# Tool Polymarket Trades

> Use the polymarket_trades tool to fetch and filter recent Polymarket trades (free Data API), optionally by market or wallet.

- Skill: `captaindpt/tool-polymarket-trades` (Agent Skill)
- Install (CLI): `npx skillmds@latest add captaindpt/tool-polymarket-trades`
- Raw SKILL.md: https://api.skillmd.com/api/skills/captaindpt/tool-polymarket-trades/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: captaindpt (https://skillmd.com/u/captaindpt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/captaindpt/tool-polymarket-trades

---


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

By wallet:
```json
{ "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`