Get earnings summary

Returns a validator earnings/profitability summary with aggregated metrics at three levels
(latest round, 1-hour average, 24-hour average), the CC price used, and the estimated traffic
(billing) cost. Net post_traffic figures can be negative when traffic cost exceeds earnings.

Unknown party: This endpoint always returns HTTP 200 — the metrics are derived from

network-wide mining rounds, so an unknown party still yields a populated summary rather than a
404. A malformed party id (not in participant::identifier form) returns HTTP 400.

Example response

{
  "cc_price_usd": 0.145792,
  "traffic_cost_cc": 6.85908691834943,
  "metrics": {
    "latest":               { "cc_per_marker_weight": 3.70, "earnings_per_billing_cc": 3.70, "post_traffic_cc": -3.16, "post_traffic_usd": -0.46 },
    "one_hour_avg":         { "cc_per_marker_weight": 4.52, "earnings_per_billing_cc": 4.52, "post_traffic_cc": -2.34, "post_traffic_usd": -0.34 },
    "twenty_four_hour_avg": { "cc_per_marker_weight": 4.55, "earnings_per_billing_cc": 4.55, "post_traffic_cc": -2.31, "post_traffic_usd": -0.34 }
  },
  "metadata": {
    "rounds_fetched": 149,
    "rounds_with_data": 149,
    "latest_round": 102363,
    "as_of": "2026-06-29T13:59:09.3184260+00:00",
    "time_zone": "UTC",
    "window_end_utc": "2026-06-29T14:06:32.3827655+00:00",
    "padded_window_start_utc": "2026-06-28T13:06:32.3827655+00:00"
  }
}
Path Params
string
required
Defaults to canton

Name of the chain.

string
required
Defaults to noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941

The party identifier to fetch earnings for.

Query Params
int64
Defaults to 1780402842

Start timestamp (Unix timestamp). Optional.

int64
Defaults to 1782994842

End timestamp (Unix timestamp). Optional.

Headers
string
required
Defaults to demokey

API Key to call the API. To generate one, visit https://noves.fi/pricing

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json