Skip to content
POST/v1/tools/get_sections· 2 credits a pull

Whale flow

Tokens moving into and out of whale wallets per day, whale count and share of supply, and wallets crossing the line.

How to get it
get_sections · sections.whale_flow
Status
Coming soon: the token page doesn't show it yet, so the API and the MCP don't serve it
Cost
2 credits a pull
Window
Up to 60 days

Get it

Ask get_sections for it by name. It answers only while the token's page shows this section; otherwise the answer leaves it out and names it in not_on_the_site_yet, and the pull is still charged. GET /v1/catalog lists the sections served right now, free

curl -X POST "https://api.blocktronics.xyz/v1/tools/get_sections" \
  -H "Authorization: Bearer $BLOCKTRONICS_KEY" \
  -H "content-type: application/json" \
  -d '{"token":"base:0x4ed4e862860bed51a9570b96d89af5e1b0efefed","section":"whale_flow"}'

Understand this metric

What the largest holders did each day. A whale holds at least 1% of tracked supply at that moment; pools, contracts, exchange and custodial wallets never count.

  • The last row is the day the scan ran, still open then: partial.
  • pass_through_tokens went into wallets that crossed the line and fell back within the day; they are left out of inflow and outflow.

In the answer

get_sections · sections.whale_flow
{
  "state": "ready",
  "sample": false,
  "origin": "engine",
  "cached_at": "2026-10-26T05:10:00.000Z",
  "age_seconds": 1800,
  "summary": "…",
  "data": {
    "whale_rule": "A wallet holding at least 1% of tracked supply at that moment.",
    "periods": [
      {
        "day": "2026-09-26",
        "whale_count": 4,
        "whale_supply_pct": 19.5,
        "inflow_tokens": 2150000,
        "outflow_tokens": 900000,
        "net_tokens": 1250000,
        "new_whales": 0,
        "exited_whales": 0
      }
    ]
  }
}
Example values

Availability and billing

A section the page shows answers with its data, cached_at and age_seconds; never a guess. See sections and credits and billing.

More parts