{"uid":"cap_ZsLrMePmZdM4CntNRlMHV","slug":"nansen-trades-by-address-7a8a68bc","name":"Nansen Prediction Market Trades By Address","description":"Get all trades for a specific wallet address across all prediction markets.\nTrades are decoded from on-chain OrderFilled events on Polygon.\n\n**What it helps to answer:**\n\n1. **What trades has this address made on Polymarket?**\n2. **When did this trader buy or sell, and at what prices?**\n3. **What markets has this address been active in?**","url":"https://api.nansen.ai/api/v1/prediction-market/trades-by-address?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."}},"description":"Request for trades by address endpoint.","additionalProperties":false},"responseSchema":{"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"},"taker_action":{"anyOf":[{"type":"string"}],"title":"Taker Action","examples":["buy"],"description":"Taker action (buy/sell)"},"outcome_index":{"anyOf":[{"type":"integer"}],"title":"Outcome Index","examples":[1],"description":"Outcome index"},"market_question":{"anyOf":[{"type":"string"}],"title":"Market Question","description":"Market question"}},"description":"Trade data from ch_api_pm_trades_by_address."},"title":"Data","description":"List of trade records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response for trades by address endpoint."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lHeDr7r0b5wkFsk0v-diR","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Retrieves all decoded on-chain prediction market trades for a specific wallet address on Polymarket (Polygon), including prices, sizes, and market context.","exampleAgentPrompt":"Pull all the Polymarket trades for wallet 0xabcdef1234567890abcdef1234567890abcdef12 from January 1, 2025 to March 31, 2025, sorted by timestamp descending, 50 per page.","exampleUseCases":null,"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:52:31.801Z","isFirstParty":false,"canonicalSlug":"nansen-trades-by-address-7a8a68bc"}