Trades By Address

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Covers the Polymarket prediction-markets dataset (trade and price history from November 2022), not per-chain history — see the Prediction Markets note on the coverage page.

Get Prediction Market Trades by Address

post

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?

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request for trades by address endpoint.

addressstring · min: 1 · max: 100Required

Wallet address (hex, with or without 0x prefix)

Example: 0x1234567890abcdef1234567890abcdef12345678

dateany ofOptional

Date range filter (ISO 8601 date-time)

Example: {"from":"2024-01-01T00:00:00Z","to":"2024-12-31T23:59:59Z"}

order_byany ofOptional

Sort order

Example: [{"direction":"DESC","field":"timestamp"}]

Responses

200

Trade data by address

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/prediction-market/trades-by-address

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/trades-by-address HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 215

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "date": {
    "from": "2024-01-01T00:00:00Z",
    "to": "2024-12-31T23:59:59Z"
  },
  "order_by": [
    {
      "direction": "DESC",
      "field": "timestamp"
    }
  ]
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "timestamp": "2024-11-01T12:30:00",
      "seller": "0x1234567890abcdef1234567890abcdef12345678",
      "buyer": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "taker_action": "buy",
      "side": "Yes",
      "outcome_index": 1,
      "size": 1000,
      "price": 0.52,
      "usdc_value": 520,
      "tx_hash": "0xabc123def456",
      "market_id": "text",
      "market_question": "text",
      "event_id": "text",
      "event_title": "text"
    }
  ]
}