Smart Activity Markets (Polymarket)

Discover markets where profitable wallets are active. Ranks Polymarket markets by recent whale-sized trading from smart-money wallets (those with a strong lifetime PnL track record), with net buy/sell pressure per market. Check _meta.warming before using the results; availability is independent for each window. Cost-basis PnL/ROI fields are not yet computed and are returned as null.

GET/v2/polymarket/markets/smart-activity

Plans All plansPlan rate limits apply

Parameters

windowstring

Optional. 1d (default), 7d, 30d, or all_time. Longer windows favor recently-active wallets.

sort_bystring

Optional. smart_volume (default), smart_wallet_count, smart_trade_count, or last_active.

orderstring

Optional. desc (default) or asc.

statusstring

Optional. Filter by market status: open or closed.

min_smart_walletsinteger

Optional. Only markets with at least this many distinct smart wallets. Default 1.

limitinteger

Optional. Page size, 1–100, default 50.

offsetinteger

Optional. Pagination offset, default 0.

Response

smart_wallet_criteriaobject

The thresholds defining a smart-money wallet for this response.

Show 2 fields

min_lifetime_pnl_usdnumber

Minimum lifetime PnL (USD) for a wallet to count as smart money.

min_trade_notional_usdnumber

Minimum per-fill notional (USD) for a trade to be counted.

windowstring

The rolling window applied (1d, 7d, 30d, or all_time).

marketsarray

Markets ranked by smart-money activity in the window.

Show 14 fields

condition_idstring

Market condition ID.

titlestring

Market title, resolved from recent trade data; null if it cannot be determined.

market_slugstring

Market slug for URL construction, resolved from recent trade data; null if it cannot be determined.

statusstring

Market status: open or closed; null if it cannot be determined.

smart_wallet_countinteger

Distinct smart-money wallets active in this market.

smart_volumenumber

Total whale-sized notional (USD) from smart wallets.

smart_trade_countinteger

Number of smart-money fills.

net_buyers_pctnumber

Fraction of smart wallets net-buying (buy volume > sell volume), 0–1.

avg_smart_lifetime_pnlnumber

Mean lifetime PnL (USD) across the active smart wallets.

last_active_tsinteger

Unix timestamp of the most recent smart-money fill in this market.

smart_realized_pnlnumber

Realized PnL from smart wallets. Not yet computed - returned as null (see _meta.unavailable_fields).

smart_total_pnlnumber

Total PnL from smart wallets. Not yet computed - returned as null.

avg_smart_roinumber

Average ROI across smart wallets. Not yet computed - returned as null.

avg_smart_win_ratenumber

Average win rate across smart wallets. Not yet computed - returned as null.

paginationobject

Offset-based pagination over the ranked list.

Show 5 fields

limitinteger

Requested page size.

offsetinteger

Page offset.

countinteger

Markets returned in this page.

totalinteger

Total markets matching the filters.

has_moreboolean

True when more markets exist beyond this page.

_metaobject

Source, data floor, and field-availability metadata.

Show 6 fields

sourcestring

Data source identifier.

warmingboolean

True means the ranking is unavailable for this window. An empty markets array is not evidence of no activity. Retry with backoff; persistent warming can indicate a failed refresh and has no guaranteed completion time. False means a completed ranking is available, which may legitimately be empty.

data_available_fromstring

ISO timestamp; trade data is served from this point onward.

unavailable_fieldsarray

Fields returned as null because they require per-wallet cost-basis accounting not yet computed.

notestring

Which fields are exact vs. not yet available.

coverage_notestring

How smart-wallet coverage relates to the chosen window.