{"uid":"cap_TnbythN93VtAUpinZtGMN","slug":"api-nansen-ai-afb513f3","name":"Nansen Prediction Market Trades by Market","description":"Get Prediction Market Trades by Market","url":"https://api.nansen.ai/api/v1/prediction-market/trades-by-market","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TradesByMarketRequest","required":["market_id"],"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)"},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[TradesByMarketSortField]","required":["field","direction"],"properties":{"field":{"enum":["timestamp"],"type":"string","title":"TradesByMarketSortField","description":"Sortable fields for trades by market 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"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"maxLength":100,"minLength":1,"description":"Polymarket market ID"},"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 market endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"TradesByMarketResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TradeByMarket","required":["market_id"],"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)"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"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"},"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"}},"description":"Trade data from ch_api_pm_trades_by_market."},"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 market 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_qsslJJ32EmdhcNWoy03ZT","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_M4R_MUIdVTqI3KtOfG_16","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 individual trade records for a specific prediction market, showing trade activity and smart money participation.","exampleAgentPrompt":"Pull all the trades for this prediction market — market ID 0x1234abcd — and show me which wallets are buying and selling, especially any Nansen smart money labels.","exampleUseCases":null,"resultDescription":"Returns a list of individual trades for the specified prediction market, including trader wallet addresses, trade direction (buy/sell), size, price, timestamp, and potentially Nansen smart money labels for the traders involved.","failureModes":["Invalid or unknown market identifier returns empty result or 404","Market not indexed by Nansen returns no data","Malformed POST body returns 400 bad request","Payment not included or insufficient returns 402 payment required","Rate limit exceeded returns 429","Chain or protocol not supported returns error"],"whenToPreferThis":"Use this endpoint when you need granular trade-level data for a specific prediction market — particularly when you want to identify which wallets (especially labeled smart money) are entering or exiting positions in a given market. Prefer this over PnL endpoints when you need raw trade activity rather than aggregated profitability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:49:33.506Z","isFirstParty":false}