Skip to content
POST/v1/tools/token_series· 2 credits per token

Cost basis series

Daily invested-versus-value, for the two-line P&L chart.

How to get it
token_series · holder_value_usd, cost_basis_usd, mvrv
Cost
2 credits per token
Window
Up to 60 days

See it

Holder value vs cost basis

Merged across Base and Robinhood: one wallet on several chains is one holder.
$15.6M−$12.9M vs cost
Holder valueCost basis
Live: DEGEN on Base, from Blocktronics' stored rows
token_series · holder_value_usd, cost_basis_usd, mvrv
{
  "metrics": [
    "holder_value_usd",
    "cost_basis_usd",
    "mvrv"
  ],
  "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"
    ],
    "holder_value_usd": [
      46902300,
      46248100
    ],
    "cost_basis_usd": [
      203087400,
      203121696
    ],
    "mvrv": [
      0.231,
      0.228
    ]
  }
}
Example shape of this part of the tool's answer

Get it

token_series returns it at holder_value_usd, cost_basis_usd, mvrv. 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":["holder_value_usd","cost_basis_usd","mvrv"],"days":30}'

Understand this metric

What holders have put in against what they hold now, every day. Plot cost_basis_usd against holder_value_usd and the gap between the lines is the unrealised position across the holder base; mvrv is the one divided by the other.

  • cost_basis_usd (the realized cap) is aggregate cost basis, what holders invested; holder_value_usd is what they hold now. Those two lines are the chart. mvrv is holder value ÷ cost basis: 1 is break-even.
  • Measured under the VALUE scope, which INCLUDES centralized-exchange balances, those tokens are investor money and belong in a capital aggregate even though the wallet holding them is not a holder. This is the opposite treatment to concentration and holder counts, and it is deliberate.

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