ASasksurf
Smart Money

Smart Money KOL Activity

Changed on

Lists what KOLs opened and closed, one row per KOL, day, market, chain, token and kind (open, close), newest first: size (perp: notional), realized PnL on closes, and the number of positions behind the row. Covers the last 90 days.

Pass up to 50 X handles in handles (comma-separated, @ optional, case-insensitive); a former handle is answered under the KOL's current one. since defaults to 7 days ago; min_usd (default 1000) drops small rows; market is spot, perp or all. The response also carries coverage for every requested handle.

Privacy: responses never include wallet addresses or transaction identifiers. Per-KOL amounts are rounded to 2 significant figures, and per-token KOL lists carry names only. Activity is aggregated per day.

Data refresh: hourly

get/gateway/v1/smart-money/kol/activity

Request

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

Query parameters

handlesstring required

Comma-separated X/Twitter handles (with or without @, case-insensitive, at most 50)

Example:frankdegods,cobie
sincestring

Earliest day to include: Unix seconds or YYYY-MM-DD (UTC). Defaults to 7 days ago; anything older than 90 days is raised to 90 days ago

Example:2026-10-20
min_usdnumber double

Minimum size in USD (perp: notional) of a row

Example:1000
market'spot' | 'perp' | 'all'

spot (on-chain DEX), perp (perpetual futures) or all

Example:all
limitinteger

Rows 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/SmartMoneyKOLActivityResponse.json"
}

Changes