# Trades By Address

## Get Prediction Market Trades by Address

> 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?\*\*

```json
{"openapi":"3.1.0","info":{"title":"Nansen API","version":"1.0.0"},"servers":[{"url":"https://api.nansen.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apiKey","description":"API key for authentication"}},"schemas":{"TradesByAddressRequest":{"properties":{"address":{"type":"string","maxLength":100,"minLength":1,"title":"Address","description":"Wallet address (hex, with or without 0x prefix)"},"pagination":{"$ref":"#/components/schemas/PaginationRequest"},"date":{"anyOf":[{"$ref":"#/components/schemas/DateRange"}],"description":"Date range filter (ISO 8601 date-time)"},"order_by":{"anyOf":[{"items":{"$ref":"#/components/schemas/SortOrder_TradesByAddressSortField_"},"type":"array"}],"title":"Order By","description":"Sort order"}},"additionalProperties":false,"type":"object","required":["address"],"title":"TradesByAddressRequest","description":"Request for trades by address endpoint."},"PaginationRequest":{"properties":{"page":{"type":"integer","minimum":1,"title":"Page","description":"Page number (1-based)","default":1},"per_page":{"type":"integer","maximum":1000,"minimum":1,"title":"Per Page","description":"Number of records per page (max 1000)","default":10}},"type":"object","title":"PaginationRequest","description":"Pagination parameters for API requests."},"DateRange":{"properties":{"from":{"anyOf":[{"type":"string"}],"title":"From","description":"Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"},"to":{"anyOf":[{"type":"string"}],"title":"To","description":"End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"}},"type":"object","title":"DateRange","description":"Date range model matching the API schema."},"SortOrder_TradesByAddressSortField_":{"properties":{"field":{"$ref":"#/components/schemas/TradesByAddressSortField","description":"Field to sort by"},"direction":{"$ref":"#/components/schemas/SortDirection","description":"Sort direction (ASC or DESC)"}},"type":"object","required":["field","direction"],"title":"SortOrder[TradesByAddressSortField]"},"TradesByAddressSortField":{"type":"string","enum":["timestamp"],"title":"TradesByAddressSortField","description":"Sortable fields for trades by address endpoint."},"SortDirection":{"type":"string","enum":["ASC","DESC"],"title":"SortDirection","description":"Enum for sort directions."},"TradesByAddressResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/PaginationInfo"},"data":{"items":{"$ref":"#/components/schemas/TradeByAddress"},"type":"array","title":"Data","description":"List of trade records"}},"type":"object","required":["data"],"title":"TradesByAddressResponse","description":"Response for trades by address endpoint."},"PaginationInfo":{"properties":{"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number","default":1},"per_page":{"type":"integer","maximum":1000,"minimum":1,"title":"Per Page","description":"Number of records per page","default":10},"is_last_page":{"type":"boolean","title":"Is Last Page","description":"Whether this is the last page","default":true}},"type":"object","title":"PaginationInfo","description":"Pagination information for API responses."},"TradeByAddress":{"properties":{"timestamp":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Timestamp","description":"Trade timestamp (ISO format)"},"seller":{"anyOf":[{"type":"string"}],"title":"Seller","description":"Seller address (hex)"},"buyer":{"anyOf":[{"type":"string"}],"title":"Buyer","description":"Buyer address (hex)"},"taker_action":{"anyOf":[{"type":"string"}],"title":"Taker Action","description":"Taker action (buy/sell)"},"side":{"anyOf":[{"type":"string"}],"title":"Side","description":"Outcome side (Yes/No)"},"outcome_index":{"anyOf":[{"type":"integer"}],"title":"Outcome Index","description":"Outcome index"},"size":{"anyOf":[{"type":"number"}],"title":"Size","description":"Trade size in tokens"},"price":{"anyOf":[{"type":"number"}],"title":"Price","description":"Price per share (0-1)"},"usdc_value":{"anyOf":[{"type":"number"}],"title":"Usdc Value","description":"Trade value in USDC"},"tx_hash":{"anyOf":[{"type":"string"}],"title":"Tx Hash","description":"Transaction hash (hex)"},"market_id":{"anyOf":[{"type":"string"}],"title":"Market Id","description":"Market ID"},"market_question":{"anyOf":[{"type":"string"}],"title":"Market Question","description":"Market question"},"event_id":{"anyOf":[{"type":"string"}],"title":"Event Id","description":"Parent event ID"},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Parent event title"}},"type":"object","title":"TradeByAddress","description":"Trade data from ch_api_pm_trades_by_address."}},"headers":{"XNansenCreditsUsed":{"description":"Number of credits consumed by this API request","schema":{"type":"string"}},"XNansenCreditsRemaining":{"description":"Total credits remaining in the user's account after this request","schema":{"type":"string"}},"RateLimitLimit":{"description":"Combined rate limit across all configured time windows","schema":{"type":"string"}},"RateLimitRemaining":{"description":"Number of requests remaining in the current limiting window","schema":{"type":"string"}},"RateLimitReset":{"description":"Time in seconds until the rate limit window resets","schema":{"type":"string"}},"XRateLimitLimitSecond":{"description":"Maximum requests allowed per second","schema":{"type":"string"}},"XRateLimitRemainingSecond":{"description":"Requests remaining in the current second","schema":{"type":"string"}},"XRateLimitLimitMinute":{"description":"Maximum requests allowed per minute","schema":{"type":"string"}},"XRateLimitRemainingMinute":{"description":"Requests remaining in the current minute","schema":{"type":"string"}},"RetryAfter":{"description":"Number of seconds to wait before making a new request","schema":{"type":"string"}}},"responses":{"BadRequestError":{"description":"Bad Request - Invalid request parameters or malformed request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"UnauthorizedError":{"description":"Authentication error - No API key found in request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"PaymentRequiredError":{"description":"Payment Required - This endpoint supports pay-per-request via the x402 protocol. The `Payment-Required` response header contains a base64-encoded JSON object describing accepted payment options (scheme, network, asset, amount, recipient). To pay, include a `Payment-Signature` header with a base64-encoded signed payment payload. See https://www.x402.org for protocol details.","headers":{"Payment-Required":{"description":"Base64-encoded JSON describing accepted payment options","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","description":"Empty object. Payment details are in the Payment-Required header."}}}},"ForbiddenError":{"description":"Forbidden - User does not have required subscription tier or has exceeded credit limit","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"NotFoundError":{"description":"Not Found - The requested resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"ValidationError":{"description":"Validation error - Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","items":{"type":"string"}},"msg":{"type":"string"},"type":{"type":"string"}}}}}}}}},"TooManyRequestsError":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying"}}}}},"headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"InternalServerError":{"description":"Internal Server Error - An unexpected error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}},"paths":{"/api/v1/prediction-market/trades-by-address":{"post":{"tags":["Prediction Markets"],"summary":"Get 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?**","operationId":"get_prediction_market_trades_by_address_api_v1_prediction_market_trades_by_address_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradesByAddressRequest"}}},"required":true},"responses":{"200":{"description":"Trade data by address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradesByAddressResponse"}}},"headers":{"X-Nansen-Credits-Used":{"$ref":"#/components/headers/XNansenCreditsUsed"},"X-Nansen-Credits-Remaining":{"$ref":"#/components/headers/XNansenCreditsRemaining"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RateLimit-Limit-Second":{"$ref":"#/components/headers/XRateLimitLimitSecond"},"X-RateLimit-Remaining-Second":{"$ref":"#/components/headers/XRateLimitRemainingSecond"},"X-RateLimit-Limit-Minute":{"$ref":"#/components/headers/XRateLimitLimitMinute"},"X-RateLimit-Remaining-Minute":{"$ref":"#/components/headers/XRateLimitRemainingMinute"}}},"400":{"description":"Bad Request","$ref":"#/components/responses/BadRequestError"},"401":{"description":"Unauthorized","$ref":"#/components/responses/UnauthorizedError"},"402":{"description":"Payment Required","$ref":"#/components/responses/PaymentRequiredError"},"403":{"description":"Forbidden","$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Not Found","$ref":"#/components/responses/NotFoundError"},"422":{"description":"Unprocessable Content","$ref":"#/components/responses/ValidationError"},"429":{"description":"Too Many Requests","$ref":"#/components/responses/TooManyRequestsError"},"500":{"description":"Internal Server Error","$ref":"#/components/responses/InternalServerError"}}}}}}
```