ASasksurf
Prediction Market

Polymarket Trades

Trade and activity history for a Polymarket market or wallet.

Filter by market (condition_id), wallet (address), outcome (Yes/No), minimum trade size, and time range. Use type=redemption for splits/merges/redemptions, type=all for everything.

Data refresh: ~5 minutes

get/gateway/v1/prediction-market/polymarket/trades

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

condition_idstring

Market condition identifier

Example:0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092
addressstring

Wallet address — returns trades where the address is maker or taker

type'trade' | 'redemption' | 'all'

Filter by activity type: trade (default, spot trades only), redemption (splits/merges/redemptions), or all (all activity). Use redemption or all to get non-trade wallet activity; address is required for these types.

outcome_label'Yes' | 'No'

Filter by outcome label: Yes or No

min_amountnumber double

Minimum trade amount in USD

fromstring

Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01)

tostring

End of time range. Accepts Unix seconds (1706745600) or date string (2024-02-01)

sort_by'timestamp' | 'notional_volume_usd'

Field to sort results by

Example:timestamp
limitinteger

Results per page

Example:50
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseInterface {}.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.