Retrieve all Polymarket prediction market trades for a specific wallet address via Nansen.
What it does
This endpoint returns all trades made by a given wallet address across Polymarket prediction markets. Trades are decoded from on-chain OrderFilled events on Polygon and joined with market metadata. Each trade record includes timestamp, buyer/seller addresses, taker action (buy/sell), outcome side (Yes/No), trade size, price, USDC value, transaction hash, and associated market/event details.
The endpoint is part of Nansen's broader Prediction Markets API suite, which covers OHLCV candles, orderbooks, top holders, PnL analysis, market/event screeners, and address summaries — all focused on Polymarket data sourced from Polygon on-chain events. The trades-by-address endpoint accepts a POST request with a JSON body containing the wallet address, optional date range, pagination, and sort order. It costs 1 credit on the Pro plan (10 on free) or $0.01 per call via x402 pay-per-request. Rate limits are enforced per-second and per-minute, reported in response headers.
Nansen's API uses OpenAPI 3.1 and returns paginated JSON responses with `is_last_page` indicators. Authentication is via an `apiKey` header, or alternatively through the x402 payment protocol for per-call billing. The endpoint supports sorting by timestamp and filtering by ISO 8601 date ranges.
Capabilities
Use cases
- —Look up all Polymarket trades a specific wallet has made to assess trading patterns
- —Monitor a known trader's prediction market activity across all markets
- —Build a dashboard showing a wallet's Polymarket buy/sell history with timestamps and prices
- —Audit prediction market positions and trade execution for a given address
- —Feed wallet-level Polymarket trade data into an AI agent for research or copy-trading analysis
Fit
Best for
- —Querying per-wallet Polymarket trade history from on-chain data
- —Agents that need structured prediction market trade feeds by address
- —Researchers analyzing Polymarket trader behavior
Not for
- —Real-time streaming of Polymarket trades (data is polled, not streamed)
- —Non-Polymarket prediction markets (only Polymarket on Polygon is supported)
- —General blockchain transaction lookups unrelated to prediction markets
Quick start
curl -X POST https://api.nansen.ai/api/v1/prediction-market/trades-by-address \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{"address": "0x1234567890abcdef1234567890abcdef12345678", "pagination": {"page": 1, "per_page": 10}}'Example
Request
{
"date": {
"to": "2024-12-31T23:59:59Z",
"from": "2024-06-01T00:00:00Z"
},
"address": "0x1234567890abcdef1234567890abcdef12345678",
"order_by": [
{
"field": "timestamp",
"direction": "DESC"
}
],
"pagination": {
"page": 1,
"per_page": 10
}
}Response
{
"data": [
{
"side": "Yes",
"size": 1000,
"buyer": "0x1234567890abcdef1234567890abcdef12345678",
"price": 0.52,
"seller": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
"tx_hash": "0xabc123def456",
"event_id": "12345",
"market_id": "654412",
"timestamp": "2024-11-01T12:30:00",
"usdc_value": 520,
"event_title": "Bitcoin Price Milestones",
"taker_action": "buy",
"outcome_index": 1,
"market_question": "Will BTC reach $100k by end of 2024?"
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear endpoint description, x402 pricing ($0.01/call), and a confirmed 402 MPP challenge indicating the endpoint is live. Crawled docs are minimal (no separate documentation site found), but the OpenAPI spec is comprehensive enough to fully describe the endpoint.
Warnings
- —No separate developer documentation site was found beyond the OpenAPI spec
- —The specific TradesByAddressRequest/Response schemas reference $ref components not fully expanded in the probe, but field descriptions are available in the OpenAPI components
Citations
- —Endpoint costs 10 credits (free) or 1 credit (pro), or $0.01 via x402https://api.nansen.ai
- —Trades are decoded from on-chain OrderFilled events on Polygonhttps://api.nansen.ai
- —Endpoint returns 402 confirming MPP livenesshttps://api.nansen.ai/api/v1/prediction-market/trades-by-address