Docs
⌘ K

User Lookup

GET/v1/polymarket/users

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.

Query Parameters

ParameterDescriptionValue
user
string
    interval
    string

    Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time.

    • Accepted values: 1h, 1d, 1w, 30d
    sort_by
    string
    • Default value: total_volume
    • Accepted values: total_volume, realized_pnl, unrealized_pnl, total_pnl, transactions
    total_volume
    limit
    integer

    Number of items* returned in a single request.
    *Plan restricted.

    • Default value: 10
    • Minimum value: 1
    • Maximum value: 1000
    page
    integer

    Page number to fetch.
    Empty data array signifies end of results.

    • Default value: 1
    • Minimum value: 1
    • Maximum value: 767465558638

    Potential Responses

    StatusDescription
    200

    Successful Response

    400

    Client side error

    401

    Authentication failed

    403

    Forbidden

    404

    Not found

    500

    Server side error