Supply profitability ratio

How to get it

token_series · supply_in_profit_pct, wallets_in_profit_pct, wallets_in_profit, wallets_in_loss

Cost

2 credits per token

Window

Up to 60 days

See it

{
  "metrics": [
    "supply_in_profit_pct",
    "wallets_in_profit_pct",
    "wallets_in_profit",
    "wallets_in_loss"
  ],
  "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"
    ],
    "supply_in_profit_pct": [
      14.4,
      14.27
    ],
    "wallets_in_profit_pct": [
      5.1,
      5.05
    ],
    "wallets_in_profit": [
      208,
      206
    ],
    "wallets_in_loss": [
      3871,
      3878
    ]
  }
}

Get it

token_series returns it at supply_in_profit_pct, wallets_in_profit_pct, wallets_in_profit, wallets_in_loss. 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":["supply_in_profit_pct","wallets_in_profit_pct","wallets_in_profit","wallets_in_loss"],"days":30}'

Understand this metric

For each day: how much of the tracked supply was acquired below the current price (in profit) against how much was acquired above it (in loss), with holder headcounts alongside. The two shares always sum to 100%, this is the read behind the stacked-area profitability chart.

• supply_in_profit_pct is computed on the server from the token amounts, so it and its complement (100 minus it, the share in loss) stack to exactly 100.
• The supply share is VALUE-scope and the wallet counts are COUNT-scope, so centralized-exchange balances are inside the supply split and outside the wallet counts. The two are answering different questions on purpose, see "Two ways to count" on the overview.
• Positions worth under $5 are excluded, so dust wallets cannot swamp the headcounts.
• A day the profitability fold has not yet computed is null, never zero.

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