Blocktronics API
Ask for exactly the data you need, as JSON: up to 60 days of holder behavior, capital flows and profitability, today by the hour, the grade and the readout. The same data the site shows, with the same tools and prices as the MCP
- chains
- 3
- days of history
- 60
- credits per pull
- 2
- tools
- 15
Make a call
Make an API key on your account page and keep it on your server. Then call a tool with its input as JSON. This one asks for 30 days of two daily metrics for one token
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":["holders","netflow_usd"],"days":30}'Endpoints
/v1/catalogEvery daily metric, the sections the token page shows, and every tool with its input and price. No key needed./v1/tools/{tool}One tool with its JSON input as the body: exactly the data you ask for./v1/queryMetrics, today, the overview, sections and the readout for up to 5 tokens in one request./v1/accountYour credits balance and the prices./v1/auth/nonceThe message an agent's wallet signs to get a key, with no person or browser. No key needed./v1/auth/keyThat signature in, a key out (shown once); a wallet with no account gets one, with no credits. No key needed./v1/topup/walletOnce per wallet: the agent's wallet signs for the key before any top-up quote may name it./v1/topup/quoteA top-up your agent pays from its own wallet in USDC, within the key's limits./v1/topup/{quote_id}That top-up: pending or credited (also ?tx= by the payment's hash)./v1/tokens/{chain}/{token}/ingestThe ingest quote for a token Blocktronics hasn't indexed./v1/tokens/{chain}/{token}/ingestBuilds that token from its first transfer./v1The index: endpoints, chains and prices. No key needed.See what comes back
Active holders
{
"metrics": [
"holders",
"holders_ge_100",
"holders_ge_1k",
"holders_ge_10k",
"holders_ge_100k"
],
"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"
],
"holders": [
4052,
4041
],
"holders_ge_100": [
1318,
1320
],
"holders_ge_1k": [
409,
410
],
"holders_ge_10k": [
95,
95
],
"holders_ge_100k": [
26,
26
]
}
}Three things to know
One metric for five tokens, one token's hours today, or several things at once with /v1/query. How to ask.
2 credits a pull (token_series: per token). Refusals, errors and quotes are free, and every answer says what it charged.
A missing value stays missing. Match time series by date, never by array position
What you can ask for
token_series serves the daily metrics, token_overview the grade and today the hours so far. get_sections serves an engine section only while the token's page shows it; GET /v1/catalog lists the ones served now
Coming soon, and not served yet by the API, the MCP or the site: predictive analysis (the Outlook and the engine's predictive scoring), history before the stored 60 days, and alerts
token_overview · gradeThe A to E grade with its six pillar scores, composite and market-structure caveats.Liquidity depthtoken_overview · grade.depthDollars that move the price 1% (D1%), from real fills, scored against the fleet by size.Today so far, hourlytoday · hours, everyone, smart_moneyThe open UTC day by hour: DEX flow and volume, plus the smart-money cohort's venue flow.Cost basis seriestoken_series · holder_value_usd, cost_basis_usd, mvrvDaily invested-versus-value, for the two-line P&L chart.Concentrationtoken_series · top10_pct, top50_pct, top100_pctTop-10, top-50 and top-100 supply share per day.Supply profitability ratiotoken_series · supply_in_profit_pct, wallets_in_profit_pct, wallets_in_profit, wallets_in_lossShare of held supply in profit versus loss, per day.Daily realized PnLtoken_series · realized_profit_usd, realized_loss_usd, realized_net_usd, sellersPer-day realized profit against loss: capitulation versus profit-taking.Smart money detailtoken_series · smart_money (smart_netflow_usd, smart_netflow_cum_usd, smart_dex_buy_usd, smart_dex_sell_usd, smart_wallets, smart_holdings_usd, smart_dex_net_usd, smart_buyers, smart_sellers, smart_requalification_usd)Beyond the net line: cohort buys and sells at the venue, requalification flow, cohort holders and position.Tokens Blocktronics hasn't indexed
A tool asked about a token Blocktronics hasn't indexed answers 400 tool_error saying so, with nothing charged. Quote it with GET /v1/tokens/{chain}/{token}/ingest, then ingest it: it is built from its first transfer, and the quote is taken when the build starts and given back if it fails. How ingesting works.
Two ways to count
Holder counts exclude centralized-exchange wallets: one hot wallet holding thousands of customers is not one holder. Capital totals include exchange balances, because those tokens are investor money. Liquidity pools, bridges and protocol contracts are excluded from both. Each part's reference names its scope
Series can have different start dates. Match observations by their day key and preserve gaps. Read the availability guide.
Custom datasets and deeper history
Custom B2B integrations can include historical price and market cap, entry-price distributions, trade microstructure and labelled-wallet tracking. Windows longer than 60 days are an enterprise conversation. Discuss a bespoke integration.