Pinax
    Polymarket prediction market data endpoints, plus API documentation and monitoring.
    Resources & endpoints
    Polymarket Users

    User Lookup

    Returns trading statistics per user: volume, PNL (realized, unrealized, total), trade counts, and activity window. When no user address is provided, returns a paginated leaderboard for discovery.

    Supports lookback windows via interval: 1h, 1d, 1w, 30d. Omit for all-time. Data refreshes hourly.

    GET
    https://api.pinax.network/v1/polymarket/users
    Requires bearer token — sign in to inject your team’s key.

    Optional parameters

    NameTypeDescription
    user
    query
    		string · evm-addressundefined
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    interval
    query
    		Enum · 4Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time.
    1h1d1w30d
    sort_by
    query
    		Enum · 5
    total_volumerealized_pnlunrealized_pnltotal_pnltransactions
    limit
    query
    		integerNumber of items* returned in a single request.
    *Plan restricted.
    page
    query
    		integerPage number to fetch.
    Empty data array signifies end of results.

    Response

    200 OK
    {
  "data": [
    {
      "user": "0x4ce73141dbfce41e65db3723e31059a730f0abad",
      "buys": 32168,
      "sells": 294299,
      "transactions": 326467,
      "volume_bought": 11882418.59,
      "volume_sold": 35795922.98,
      "total_volume": 47678341.57,
      "realized_pnl": 23913504.39,
      "unrealized_pnl": 12090462.43,
      "total_pnl": 36003966.82,
      "first_trade": "2024-05-30 00:00:00",
      "last_trade": "2024-11-28 00:00:00"
    }
  ]
}