Skip to main content
GET
/
indicator
/
pnl
/
realized-profit-loss
Realized Net Profit and Loss
curl --request GET \
  --url https://api.cryptoquant.com/v2/indicator/pnl/realized-profit-loss \
  --header 'Authorization: Bearer <token>'
{
  "status": {
    "code": 123,
    "message": "<string>"
  },
  "result": {
    "window": "<string>",
    "data": [
      {
        "date": "<string>",
        "positive_net_realized_profit": 123,
        "negative_net_realized_profit": 123,
        "yearly_realized_net_profit_btc": 123,
        "yearly_realized_net_profit_usd": 123,
        "monthly_realized_net_profit_btc": 123,
        "monthly_realized_net_profit_usd": 123
      }
    ]
  }
}

What it measures

Total USD or BTC value of profit or loss realized by all Bitcoin holders on a given day, 30-day and 365-day rolling window.

How to interpret it

Single large loss days are not automatic bottom signals. Watch for patterns: cumulative monthly losses vs. prior bear market levels is more reliable than single-day readings. Declining profit peaks forming lower highs = bull-to-bear transition. BTC-denominated = best for structural cycle analysis across time. USD-denominated = best for measuring real-world economic impact. Rising annual profits = bull market in full force. Declining annual profit peaks = cycle top has passed. Monthly data provides near-term confirmation of profit-taking or capitulation cycles. Compare monthly readings in BTC terms against prior bear market capitulation benchmarks, not just USD figures.

Key thresholds

5.4Bsingledayloss(Feb5,2026)=largestsinceMar2023,butinsufficientforstructuralbottom;5.4B single-day loss (Feb 5, 2026) = largest since Mar 2023, but insufficient for structural bottom; 9B single-day profit (Jul 2025) = local peak; Monthly BTC losses >1.1M BTC = historical capitulation level; 0.3M BTC (Feb 2026) = far below capitulation level BTC terms: 4.4M BTC annual net profit (Oct 2025) = cycle peak at $126K ATH; +2.5M BTC (Jan 2026) = –43% from peak in 3 months, comparable to Mar 2022 (start of prior bear); Declining annual profit peaks forming lower highs = definitive bull-to-bear signal. Monthly data: 0.53M BTC (Jul 2025) = near-ATH monthly profits; +0.26M BTC (Oct 2025) = 50% below July, early momentum warning; 0.3M BTC monthly losses (Feb 2026) = far below 1.1M BTC capitulation level of 2022

How to use it

Watch for patterns over weeks. Rising daily losses with declining price = capitulation approaching. Rising daily profits with declining trend = distribution phase ending. Successive lower profit peaks = bear market transition signal. The annual trend is the most reliable cycle signal. When annual profits begin forming lower peaks and are below its 30-day moving average, even as prices remain near highs, the cycle top has likely passed. 30-day data: Use alongside daily and annual figures for multi-timeframe confirmation. Monthly BTC-denominated losses approaching 1.1M BTC = structural capitulation approaching.

Run this metric in CryptoQuant Analytics

Authorizations

Authorization
string
header
required

For each API request, include the Authorization HTTP header with Bearer {access_token}.

Query Parameters

window
string
default:day

Time interval for aggregation.

from
string

Starting time, formatted as YYYYMMDDTHHMMSS (UTC). If window=day, YYYYMMDD is also accepted.

to
string

Ending time, formatted as YYYYMMDDTHHMMSS (UTC). If window=day, YYYYMMDD is also accepted.

limit
integer

Maximum number of data rows to return.

Response

200 - application/json

bitcoin spending behavior

status
object
required

Returned with every response; indicates whether the request was successful.

result
object
required