{"uid":"cap_h0oZoNOUIdIUQ5HGlUCDC","slug":"api-nansen-ai-47a7298c","name":"Nansen Prediction Market Trades by Address","description":"Get Prediction Market Trades by Address","url":"https://api.nansen.ai/api/v1/prediction-market/trades-by-address","method":"GET","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":"SortOrder[TradesByAddressSortField]","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":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jdNFfxgjpcDrqMXJC1UgU","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_WJwOskNRM03fQx6bPB6ZQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves prediction market trade history for a specific wallet address, showing all trades made by that address across prediction markets.","exampleAgentPrompt":"Pull up all the prediction market trades for wallet address 0x4b5922abf25858d012d3ab2d6f89c0df1d61a738 using Nansen — I want to see what bets this address has been making.","exampleUseCases":null,"resultDescription":"Returns a list of prediction market trades associated with the specified wallet address, including trade details such as market, position, size, price, and timestamps.","failureModes":["Invalid or malformed wallet address returns 400 error","Address with no prediction market activity returns empty result set","Rate limiting or quota exceeded returns 429 error","Network or upstream Nansen data source unavailable returns 503","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Use this endpoint when you need to analyze prediction market activity for a specific wallet address — ideal for tracking smart money behavior, researching a counterparty's betting history, or building wallet-level analytics on prediction market participation. Choose this over the market-level endpoint when the wallet address is your primary filter rather than the market itself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:54:36.465Z","isFirstParty":false}