ASasksurf
Smart Money

Smart Money KOL Holdings

Changed on

Returns KOLs' current portfolios in USD: total and DeFi value, the largest token holdings with their share of the total (stablecoins combined as STABLES), and open perp positions by notional. USD values only, never token amounts.

Pass up to 50 X handles in handles (comma-separated, @ optional, case-insensitive); a former handle is answered under the KOL's current one. min_usd (default 500) drops small holdings; limit caps holdings per KOL.

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.

Data refresh: hourly

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

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
min_usdnumber double

Minimum USD value of a holding or perp position

Example:500
limitinteger

Token holdings (and perp positions) per KOL

Example:20

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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

Changes