POST
/v1/tools/get_sections· 2 credits a pullWhale 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
}
]
}
}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.