Skip to content

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:

FieldDefinition
max_supplyMaximum supply reported by the configured NMR token.
total_supplyCurrent supply reported by the configured NMR token.
total_burnedmax_supply minus total_supply. Every refresh asserts that these three canonical token-supply values reconcile exactly.
circulating_supplyTotal supply minus the balances of the published Numerai treasury addresses.
numerai_treasuryThe published Numerai-owned wallet addresses and value, their current combined NMR balance.
current_stake_amountCurrent legacy, Atomic, and Erasure stake after confirmed legacy-to-Atomic migrations are deducted once.
current_staker_countUnique Numerai accounts with positive current legacy or Atomic stake. Erasure owners are not included because the available data cannot safely deduplicate them with Tournament accounts.
current_stake_breakdownCurrent stake grouped by tournament, chain, Atomic contract address, and staking generation.

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.

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:

text
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:

text
GET https://nmr-info.numer.ai/nmr/history?start_date=2025-01-01&end_date=2025-01-31
json
{
  "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.