POST
/v1/tools/get_sections· 2 credits a pullProfit and loss
Realized price, profit and loss bands, whale unrealised PnL.
- How to get it
get_sections · sections.pnl_snapshot- 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":"pnl_snapshot"}'Understand this metric
Current-state profitability in detail: the realized price and market cap, totals in profit and loss, and holder counts bucketed by ROI so you can show the distribution rather than one average.
- break_even_zones restates every band as the prices those holders paid: a holder at ROI r bought at current_price ÷ (1 + r).
- This section carries both scopes at once: holders_profit / holders_loss and the band histograms are COUNT-scope, while realized_price, realized_mcap, the USD totals and supply_profit / supply_loss are VALUE-scope. Do not derive an average position size by dividing one by the other, the numerator and denominator cover different sets of addresses.
In the answer
get_sections · sections.pnl_snapshot
{
"state": "ready",
"sample": false,
"origin": "engine",
"cached_at": "2026-10-26T05:10:00.000Z",
"age_seconds": 1800,
"summary": "…",
"data": {
"current_price": 0.00072,
"realized_price": 0.0031,
"realized_mcap": 203121696,
"total_supply": 1000000000,
"total_holders": 4084,
"total_usd_profit": 1240000,
"total_usd_loss": 8100000,
"supply_profit": 12.4,
"supply_loss": 87.6,
"holders_profit": 206,
"holders_loss": 3878,
"profit_bands": [
{
"key": "p_51_100",
"side": "profit",
"lo": 51,
"hi": 100,
"holders": 28
}
],
"loss_bands": [
{
"key": "l_10_20",
"side": "loss",
"lo": 10,
"hi": 20,
"holders": 402
}
],
"whale_pnl": [
{
"key": "1_2",
"lo": 1,
"hi": 2,
"whales": 3,
"pnl_usd": 42000
}
],
"break_even_zones": [
{
"band": "l_10_20",
"side": "loss",
"entry_price_low": 0.0008,
"entry_price_high": 0.000911,
"holders": 402,
"supply_tokens": 61200000,
"supply_pct": 6.1
}
],
"coverage": {
"transfers": 182044,
"priced": 179310,
"oldest": "2025-10-21",
"newest": "2026-09-26"
}
}
}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.