NMR token data

About NMR

NMR (Numeraire) is Numerai's utility token. Its role is to be the asset you put at risk on your own predictions: you stake NMR on a submission, and after scoring positive scores pay out more NMR while negative scores burn part of your stake. Payouts use NMR rather than USD specifically because NMR can be burned - sent to a null address and made permanently unusable by anyone, including Numerai.

NMR is not equity in Numerai. Holding or staking NMR confers no ownership, no shareholding, no voting or governance rights, no dividends, no revenue or profit share, and no claim on Numerai, on Numerai's hedge fund, on assets under management, or on any fees Numerai earns. It does not make you an investor in the fund and does not entitle you to fund performance. See the FAQ for more, and Staking for how staking works.

Supply data

Numerai publishes current NMR supply and staking metadata at https://nmr-info.numer.ai/nmr.

The service refreshes its source data hourly. last_updated is when the latest successful cache was published, while data_as_of is when that source refresh began. Responses also expose data_as_of through the X-NMR-Data-As-Of header. Amount values in the JSON response are decimal strings; count values are JSON numbers.

The response includes:

Field	Definition
max_supply	Maximum supply reported by the configured NMR token.
total_supply	Current supply reported by the configured NMR token.
total_burned	max_supply minus total_supply. Every refresh asserts that these three canonical token-supply values reconcile exactly.
circulating_supply	Total supply minus the balances of the published Numerai treasury addresses.
numerai_treasury	The published Numerai-owned wallet addresses and value, their current combined NMR balance.
total_value_locked_nmr	Current total NMR staked in on-chain Numerai contracts: the sum of on-chain-v1 and on-chain-v2 entries in current_stake_breakdown. Off-chain stakes and Erasure agreements are excluded.
total_value_locked_usd	total_value_locked_nmr multiplied by the latest NMR/USD price in Numerai's database at the hourly refresh.
current_stake_amount	Current NMR staked on Numerai, including off-chain and on-chain staking, after confirmed migrations are deducted once. Erasure agreements are excluded.
current_stake_amount_erasure	Current NMR locked in Erasure agreements, reported separately from Numerai stake.
current_staker_count	Unique Numerai accounts with positive current stake, including off-chain and on-chain staking. Erasure owners are not included because the available data cannot safely deduplicate them with Tournament accounts.
current_stake_breakdown	Current Numerai stake grouped by tournament, chain, contract address, and staking generation (off-chain, on-chain-v1, or on-chain-v2). Erasure agreements are excluded.

The same values are also available from scalar endpoints such as /nmr/total_burned, /nmr/current_stake_amount, and /nmr/current_staker_count. /nmr/numerai_treasury returns the treasury addresses and their combined NMR value as an object. The treasury value is read in the same hourly snapshot as supply, so total_supply minus that value equals circulating_supply.

Both TVL fields return objects with description and a decimal-string value. The USD valuation uses the latest recorded price, refreshed with the rest of the hourly cache; it is not a real-time quote. If the price is missing, zero or negative, or cannot be read, the refresh fails and the previous cache is retained.

Tournament staking and burns

https://nmr-info.numer.ai/tournament reports Tournament staking metrics. Current stake includes both legacy and Atomic positions. When stake is migrated to an Atomic strategy, its confirmed migration amount is subtracted from the legacy ledger before Atomic positions are added, preventing double counting. Each stake is combined and floored at zero on its own, so a stake whose legacy ledger sits below its migrated or burned amount reports as zero rather than reducing anyone else's stake.

total_burned on the Tournament response has different semantics from total_burned on the NMR response. The Tournament value is the existing legacy burn baseline plus burn amounts allocated by resolved Atomic claims. An Atomic allocation can be deferred or unclaimed, so it does not necessarily mean token supply has already decreased. burn_allocation_breakdown groups these economic allocations by tournament, chain, and contract.

If an hourly refresh fails, the service retains the previous successful cache. There is currently no maximum cache age; consumers should inspect last_updated and data_as_of before using the values.

Supply history

Daily total and circulating supply are available from:

GET https://nmr-info.numer.ai/nmr/history

The response contains one point per UTC day from the NMR contract deployment through the current day. total_supply and circulating_supply are JSON strings so their full 18-decimal precision is preserved.

Use the optional, inclusive start_date and end_date query parameters to select a range. Dates must use YYYY-MM-DD format:

GET https://nmr-info.numer.ai/nmr/history?start_date=2025-01-01&end_date=2025-01-31

{
  "interval": "day",
  "start_date": "2025-01-01",
  "end_date": "2025-01-31",
  "data": [
    {
      "date": "2025-01-01",
      "total_supply": "...",
      "circulating_supply": "..."
    }
  ]
}

Before the NMR 2.0 upgrade, historical total supply follows on-chain mint events and confirmed tournament stake burns. NMR 2.0 reset total supply to the supply cap; subsequent history subtracts confirmed on-chain burns from that cap. Historical circulating supply additionally subtracts the combined balance of the treasury addresses published by the current endpoint. Before NMR 2.0, it also subtracts minted NMR that remained undistributed in the token contract.