---
title: "Get Prediction Market Trades by Address"
method: POST
path: "/api/v1/prediction-market/trades-by-address"
tags: ["Prediction Markets"]
---

# Get Prediction Market Trades by Address

`POST /api/v1/prediction-market/trades-by-address`

## Request

- Base URL: `https://api.nansen.ai`
- URL: `https://api.nansen.ai/api/v1/prediction-market/trades-by-address`
- Auth: API key in header `apiKey`
- TypeScript: <https://skmtc.dev/nansen/apis/nansen-api/docs/api/v1/prediction-market/trades-by-address/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Request body

- TradesByAddressRequest: Request for trades by address endpoint.
  - `address` string, required: Wallet address (hex, with or without 0x prefix)
  - `pagination` PaginationRequest: Pagination parameters for API requests.
    - `page` integer: Page number (1-based)
    - `per_page` integer: Number of records per page (max 1000)
  - `date` DateRange: Date range model matching the API schema.
    - `from` string: Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)
    - `to` string: End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)
  - `order_by` SortOrderTradesByAddressSortField[]: Sort order
    - `field` 'timestamp', required: Sortable fields for trades by address endpoint.
    - `direction` 'ASC' | 'DESC', required: Enum for sort directions.

## Response `200`

Trade data by address

- TradesByAddressResponse: Response for trades by address endpoint.
  - `pagination` PaginationInfo: Pagination information for API responses.
    - `page` integer: Current page number
    - `per_page` integer: Number of records per page
    - `is_last_page` boolean: Whether this is the last page
  - `data` TradeByAddress[], required: List of trade records
    - `timestamp` string, date-time: Trade timestamp (ISO format)
    - `seller` string: Seller address (hex)
    - `buyer` string: Buyer address (hex)
    - `taker_action` string: Taker action (buy/sell)
    - `side` string: Outcome side (Yes/No)
    - `outcome_index` integer: Outcome index
    - `size` number: Trade size in tokens
    - `price` number: Price per share (0-1)
    - `usdc_value` number: Trade value in USDC
    - `tx_hash` string: Transaction hash (hex)
    - `market_id` string: Market ID
    - `market_question` string: Market question
    - `event_id` string: Parent event ID
    - `event_title` string: Parent event title

## Other responses

- `400`: Bad Request - Invalid request parameters or malformed request
- `401`: Authentication error - No API key found in request
- `402`: Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.
- `403`: Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404`: Not Found - The requested resource was not found
- `422`: Validation error - Invalid request parameters
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/nansen/apis/nansen-api.md) - [All operations](https://skmtc.dev/nansen/apis/nansen-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nansen/apis/nansen-api/revisions/02a4d2e7d827?raw)