Smart Money Token Calls

GET/gateway/v1/smart-money/token/calls

Ranks tokens by how many tracked KOLs called them bullish on X, and checks the calls against their positions: how many callers held the token when calling, who called first, how fast others followed, and the net flow of all tracked KOLs on the token.

`time_range` is `7d`, `30d` or `120d`. Major assets are excluded unless `include_majors=true`.

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: daily

Query Parameters

time_rangeenum<string>

Window to count calls over

Available options:7d30d120d

Example: 30d

include_majorsboolean

Include major assets (BTC, ETH, SOL, ...)

Example: false

chainenum<string>

Restrict to tokens on one chain (canonical long-form names)

Available options:solanaethereumbasebscarbitrumrobinhoodhyperevmmonadarcpolygonavalancheoptimismworldchaininkxlayercronoscelounichainberachainkatanaflareroninlineaplasmamantleabstractzksyncsonicgnosisgravityhemiplumezorascrollsoneiummegaethmantaetherlinkmodefusecitreafraxtaltaikobobsophonxdcmetisseirootstockkaiazircuitzetachainliskconfluxmorphapechainbitlayercorestorystabletempo

Example: solana

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Smart Money Token Calls

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/smart-money/token/calls?time_range=30d&include_majors=false&chain=solana&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseSmartMoneyTokenCall.json",
  "data": [
    {
      "callers": [
        {
          "first_call_at": 123,
          "handle": "<string>",
          "held_or_bought_after": true,
          "n_calls": 123
        }
      ],
      "category": "<string>",
      "first_call_at": 123,
      "first_caller": "<string>",
      "is_major": true,
      "last_call_at": 123,
      "n_checked": 123,
      "n_first_48h": 123,
      "n_held_at_call": 123,
      "n_long_callers": 123,
      "n_pool_buyers": 123,
      "n_short_callers": 123,
      "pool_net_flow_usd": 123,
      "rank": 123,
      "shorters": [
        {
          "handle": "<string>",
          "n_calls": 123
        }
      ],
      "time_range": "<string>",
      "token": {
        "address": "<string>",
        "chain": "<string>",
        "is_stock": true,
        "name": "<string>",
        "symbol": "<string>"
      },
      "token_age_days": 123,
      "views": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}