# Nansen Prediction Market Trades By Address > Nansen Prediction Market Trades By Address is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-09). Retrieves all decoded on-chain prediction market trades for a specific wallet address on Polymarket (Polygon), including prices, sizes, and market context. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/prediction-market/trades-by-address?utm_source=zero.xyz - Price: $0.01/call - Payment: MPP - Status: unknown - Last checked: 2026-10-09 - Activations on Zero: 0 - Provider: Nansen - Docs: https://docs.nansen.ai - Website: https://nansen.ai - Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data - Canonical page: https://www.zero.xyz/c/nansen-trades-by-address-7a8a68bc - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZsLrMePmZdM4CntNRlMHV Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability nansen-trades-by-address-7a8a68bc -d '' ``` Example prompt: Pull all the Polymarket trades for wallet 0xabcdef1234567890abcdef1234567890abcdef12 from January 1, 2025 to March 31, 2025, sorted by timestamp descending, 50 per page. ## When to prefer this Use this endpoint when you need the full trade-level history for a specific wallet on Polymarket, including individual transaction details, prices paid, and market context. Prefer this over aggregated endpoints when you need granular per-trade data, want to reconstruct a wallet's position history, or are analyzing trading patterns for a known address. Best for wallet profiling, smart money tracking, and PnL reconstruction on Polymarket. ## Known failure modes - Invalid or malformed wallet address returns a validation error - Address with no Polymarket trades returns an empty data array - Invalid date range format returns a 400 error - Pagination page beyond available results returns empty data - Rate limit exceeded returns a 429 error - Missing required address field returns a validation error ## How this service works Get all trades for a specific wallet address across all prediction markets. Trades are decoded from on-chain OrderFilled events on Polygon. **What it helps to answer:** 1. **What trades has this address made on Polymarket?** 2. **When did this trader buy or sell, and at what prices?** 3. **What markets has this address been active in?** ## Output Returns a paginated list of trade records for the given wallet, each containing: trade side (Yes/No), size in tokens, price per share (0-1), USDC value, buyer and seller addresses, transaction hash, market ID, event ID, event title, market question, taker action (buy/sell), outcome index, and ISO timestamp. Also includes pagination metadata (page, per_page, total). ## Request schema (JSON Schema) ```json { "type": "object", "title": "TradesByAddressRequest", "required": [ "address" ], "properties": { "date": { "anyOf": [ { "type": "object", "title": "DateRange", "properties": { "to": { "anyOf": [ { "type": "string" } ], "title": "To", "examples": [ "2025-01-31T23:59:59Z" ], "description": "End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)" }, "from": { "anyOf": [ { "type": "string" } ], "title": "From", "examples": [ "2025-01-01T00:00:00Z" ], "description": "Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)" } }, "description": "Date range model matching the API schema." } ], "examples": [ { "to": "2024-12-31T23:59:59Z", "from": "2024-01-01T00:00:00Z" } ], "description": "Date range filter (ISO 8601 date-time)" }, "address": { "type": "string", "title": "Address", "examples": [ "0x1234567890abcdef1234567890abcdef12345678" ], "maxLength": 100, "minLength": 1, "description": "Wallet address (hex, with or without 0x prefix)" }, "order_by": { "anyOf": [ { "type": "array", "items": { "type": "object", "title": "TradesByAddressSortOrder", "required": [ "field", "direction" ], "properties": { "field": { "enum": [ "timestamp" ], "type": "string", "title": "TradesByAddressSortField", "description": "Sortable fields for trades by address endpoint." }, "direction": { "enum": [ "ASC", "DESC" ], "type": "string", "title": "SortDirection", "description": "Enum for sort directions." } } } } ], "title": "Order By", "examples": [ [ { "field": "timestamp", "direction": "DESC" } ] ], "description": "Sort order" }, "pagination": { "type": "object", "title": "PaginationRequest", "properties": { "page": { "type": "integer", "title": "Page", "default": 1, "minimum": 1, "description": "Page number (1-based)" }, "per_page": { "type": "integer", "title": "Per Page", "default": 10, "maximum": 1000, "minimum": 1, "description": "Numbe … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "title": "TradesByAddressResponse", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "title": "TradeByAddress", "properties": { "side": { "anyOf": [ { "type": "string" } ], "title": "Side", "examples": [ "Yes" ], "description": "Outcome side (Yes/No)" }, "size": { "anyOf": [ { "type": "number" } ], "title": "Size", "examples": [ 1000 ], "description": "Trade size in tokens" }, "buyer": { "anyOf": [ { "type": "string" } ], "title": "Buyer", "examples": [ "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd" ], "description": "Buyer address (hex)" }, "price": { "anyOf": [ { "type": "number" } ], "title": "Price", "examples": [ 0.52 ], "description": "Price per share (0-1)" }, "seller": { "anyOf": [ { "type": "string" } ], "title": "Seller", "examples": [ "0x1234567890abcdef1234567890abcdef12345678" ], "description": "Seller address (hex)" }, "tx_hash": { "anyOf": [ { "type": "string" } ], "title": "Tx Hash", "examples": [ "0xabc123def456" ], "description": "Transaction hash (hex)" }, "event_id": { "anyOf": [ { "type": "string" } ], "title": "Event Id", "description": "Parent event ID" }, "market_id": { "anyOf": [ { "type": "string" } ], "title": "Market Id", "description": "Market ID" }, "timestamp": { "anyOf": [ { "type": "string", "format": "date-time" } ], "title": "Timestamp", "examples": [ "2024-11-01T12:30:00" ], "description": "Trade timestamp (ISO format)" }, "usdc_value": { "anyOf": [ { "type": "number" } ], "title": "Usdc Value", "examples": [ 520 ], "description": "Trade value in USDC" }, "event_title": { "anyOf": [ { "type": "string" } ], "title": "Event Title", "description": "Parent event title" }, … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-trades-by-address-7a8a68bc/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)