POST
/v1/tools/token_series· 2 credits per tokenCost 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
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
]
}
}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.