Concentration

How to get it

token_series · top10_pct, top50_pct, top100_pct

Cost

2 credits per token

Window

Up to 60 days

See it

{
  "metrics": [
    "top10_pct",
    "top50_pct",
    "top100_pct"
  ],
  "days": 2,
  "from": "2026-10-24",
  "to": "2026-10-25",
  "format": "columns",
  "summary": {
    "…": "first, last, change, min, max, total and null days for each metric"
  },
  "unavailable": {},
  "data": {
    "day": [
      "2026-10-24",
      "2026-10-25"
    ],
    "top10_pct": [
      27.1,
      27
    ],
    "top50_pct": [
      48.3,
      48.2
    ],
    "top100_pct": [
      61.6,
      61.5
    ]
  }
}

Get it

token_series returns it at top10_pct, top50_pct, top100_pct. Ask for these metrics alone, or with others, for up to 5 tokens at once.

curl -X POST "https://api.blocktronics.xyz/v1/tools/token_series" \
  -H "Authorization: Bearer $BLOCKTRONICS_KEY" \
  -H "content-type: application/json" \
  -d '{"token":"base:0x4ed4e862860bed51a9570b96d89af5e1b0efefed","metrics":["top10_pct","top50_pct","top100_pct"],"days":30}'

Understand this metric

How much of the supply the largest holders control, tracked daily so you can show concentration building or dispersing rather than a single snapshot.

• Known infrastructure addresses are excluded, DEX liquidity pools, bridges, protocol contracts, and centralized-exchange hot wallets, so this reflects genuine holders. Leaving a CEX wallet in would register thousands of customers as a single mega-whale and corrupt every share on this chart.
• The three shares are nested: top50_pct includes the top 10, top100_pct the top 50. Subtract to get the next 40 and the next 50.
• A missing day means not trusted for that day, not zero concentration.

Availability and billing

A day with no figure is null, never 0, and unavailable names a panel that couldn't be read, with the reason. Keep gaps as gaps. See data availability and credits and billing.

More parts