Prediction Market

Polymarket Smart Money

Smart wallet analytics for Polymarket markets.

view=positioning (default): Aggregate smart wallet direction per market — net bullish/bearish signal and conviction. view=trades: Individual $10K+ trades with wallet address, amount, outcome, price, and wallet age.

Data refresh: ~5 minutes

get/gateway/v1/prediction-market/polymarket/smart-money

Request

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

Query parameters

view'positioning' | 'trades'

positioning = aggregate smart wallet direction per market; trades = individual $10K+ trades with wallet metadata

condition_idstring

Filter to a specific market (omit to browse all)

category'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports'

Filter by category

direction'bullish' | 'bearish' | 'neutral'

Filter by net smart money direction (only for view=positioning)

whale_tier'whale' | 'large' | 'mega'

Trade size tier filter (only for view=trades)

fromstring

Start time as Unix seconds or date string (only for view=trades)

tostring

End time as Unix seconds or date string (only for view=trades)

sort_by'smart_wallets_involved' | 'smart_buy_volume_usd' | 'smart_sell_volume_usd' | 'amount_usd' | 'block_time'

Sort field

order'asc' | 'desc'

Sort direction

limitinteger

Results per page

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.