Docs
⌘ K

Market Activity

GET/v1/polymarket/markets/activity

Returns a chronological feed of on-chain trades, position splits, merges, and redemptions. Each row includes the transaction hash, block number, and scaled amounts.

For trades, market.token_id and market.outcome_label identify the specific outcome token. For splits, merges, and redemptions, these are null because the operation applies to the market as a whole.

At least one of user, token_id, or condition_id is required. Defaults to the last 24 hours when no time range is specified — provide start_time and end_time to query older data.

Query Parameters

ParameterDescriptionValue
user
string
    token_id
    string
      condition_id
      string
        event_type
        string

        Filter by event type

        • Accepted values: trade, split, merge, redeem
        start_time
        string

        UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

          end_time
          string

          UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

            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