Tier distribution

How to get it

get_sections · sections.holder_tiers

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":"holder_tiers"}'

Understand this metric

Holder counts bucketed by USD position size, per day, with the USD value held by each cohort. The read behind a holder-makeup chart.

• A missing day means NOT TRUSTED for that day (a price-collapse guard), never zero holders. Filling it with 0 draws a cliff that did not happen.
• usd_boundaries are the floor of each tier in USD of position; the four tiers add up to holders_total.
• val_custodial_usd is exchange and custodial wallets' balance, kept apart from the tiers.
• Counted under the HOLDER-COUNT scope: centralized-exchange wallets are excluded, because one hot wallet holding thousands of customers is not one holder. See "Two ways to count" on the overview.

In the answer

{
  "state": "ready",
  "sample": false,
  "origin": "engine",
  "cached_at": "2026-10-26T05:10:00.000Z",
  "age_seconds": 1800,
  "summary": "…",
  "data": {
    "usd_boundaries": {
      "retail": 5,
      "small": 1000,
      "mid": 10000,
      "whale": 100000
    },
    "periods": [
      {
        "day": "2026-09-26",
        "holders_total": 4041,
        "tier_retail": 3200,
        "tier_small": 620,
        "tier_mid": 180,
        "tier_whale": 41,
        "val_retail_usd": 120000,
        "val_small_usd": 340000,
        "val_mid_usd": 900000,
        "val_whale_usd": 2100000,
        "val_custodial_usd": 410000,
        "holders_ge_100": 1320
      }
    ]
  }
}

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