Skip to content

Atomic Blockchain Staking

Atomic Blockchain Staking is Numerai's blockchain-native staking system. It is also called staking v3 in API and contract names. In this system, each stake is defined atomically for each (round, staker, model) - each backed by real NMR in the staking contract instead of sharing a single stake across multiple unresolved rounds.

Once a round resolves, the stake can be claimed for its original stake plus a payout or minus a burn. You can also "claim and restake" atomically in one transaction (either both operations succeed, or the entire transaction reverts).

You can interact with the contracts and API directly, or automate staking with an allocation strategy. Most users should use Dashboard > V3 Stakes, which manages the Privy embedded wallet and allocation strategy flow.

Getting Started

INFO

It is important to note that the opportunity to stake is not an offer by Numerai to participate in an investment contract, a security, a swap based on the return of any financial assets, an interest in Numerai’s hedge fund, or in Numerai itself or any fees we earn. Users with different expectations should not stake.

Please read our Terms of Service for further information.

  1. Go to Dashboard > V3 Stakes.

  2. Use an email code to authenticate your Privy wallet. This wallet is assigned to your account and shared across tournaments. It owns your stakes and allocation strategy.

  3. Enable your account allocation strategy. This is is a smart contract owned by your wallet and invocable by Numerai. There is 1 strategy contract per account per tournament.

  4. Deposit NMR into the allocation strategy. This NMR is idle because it's not currently deployed into our staking contract. Idle NMR can be used to stake on future rounds.

  5. Configure each model's per-round stake and payout mode, then save the model settings. These settings are stored in the allocation strategy and will be used to stake idle NMR next round.

  6. Numerai invokes this contract each round to automate staking for you. If you continue submitting normally and have sufficient idle NMR in your allocation strategy, you will stake automatically.

  7. When a round resolves, your stake becomes "claimable". If you continue submitting, Numerai will automatically claim your resolved stake and restake it on the next round for you. Otherwise, it remains claimable until you claim it or Numerai finalizes it on the first scoring-resolution run after the seven-day grace period.

You can also monitor Stake Activity and Wallet Activity on the V3 Stakes page including transfers and auto-stakes.

Per-round stake

The per-round stake is the amount of NMR you lock up each round. If you have a total stake budget of B and a tournament has R concurrently unresolved rounds, set the per-round stake to S = B / R.

TournamentConcurrent Rounds (R)Per-round Stake S
Numerai24B / 24
Signals64B / 64
Crypto24B / 24

For example, allocating a total of 24 NMR to Numerai means staking 1 NMR per round for 24 rounds.

Allocation Strategies

Numerai operates your allocation strategy on your behalf by invoking your saved per-model stake settings. Numerai only places authorized stakes and claims resolved positions based on your settings.

An account has one allocation strategy with separate configuration for each (tournament, model). The configuration includes a per-round stake, a mode, and whether automation is enabled. A stake is only placed when the model has an eligible selected submission for the open round and the strategy has enough releasable or idle NMR.

Atomic Blockchain Staking supports two automated modes:

  • Compound: stakes the greater of the configured per-round minimum and the releasable value from the newest eligible claim that resolved before the new round opened. A later-resolving claim waits for a future invocation. Compound does not sweep unrelated idle strategy NMR into the stake.
  • Fixed: claims all resolved positions available at invocation and stakes exactly the configured per-round amount. Extra releasable value remains idle in the allocation strategy. This is the website label for the contract's Constant mode, also known as take-profit.

If eligible claim value does not provide enough NMR for the next target stake, the strategy adds available idle NMR. If the combined amount is still below the target but greater than zero, such as after a burn, either mode stakes that smaller funded amount. This partial stake keeps the model participating; a later invocation restores the configured target once the strategy has enough NMR. The model is skipped and Numerai sends a funding-shortage notification only when no releasable or idle NMR is available.

Round Lifecycle

Each position moves through the same sequence: the round opens, NMR is staked, scores are finalized, the round resolves on-chain, and the position is claimed or rolled into a later round.

  1. Create and open the round. Numerai creates the round on-chain with its tournament ID and timing based on the off-chain database round. The on-chain staking window intentionally closes after the off-chain round, giving Numerai time to invoke enabled allocation strategies.

  2. Authorize and place stakes. For each eligible selected submission, Numerai signs an EIP-712 authorization that binds the tournament, round, staker, model, submission hash, maximum amount, nonce, and deadline. The staker or allocation strategy submits the authorization and stake amount. The contract verifies the signature and nonce, then records one position for (round, staker, model) and permits only one staker for each (round, model). Numerai invokes enabled allocation strategies before the on-chain staking window closes.

  3. Score and prepare settlement. Numerai computes scores each day. After the final scoring day, Numerai calculates each position's payout or burn and creates a claim containing the round, staker, model, payout amount, and burn amount. The claims form a Merkle tree.

  4. Resolve the round on-chain. Numerai posts the Merkle root and aggregate payout and burn amounts, then funds the positive payout liability. The contract marks the round resolved and reserves the stake and payout balances required for its claims. Positions are now claimable, but resolution alone does not move any NMR.

Until that on-chain resolution succeeds, public stake values continue to show the position's original principal. A generated, root-posted, funding-pending, or failed settlement does not apply its payout or burn. Once resolved, the settlement delta is recorded at the on-chain resolution time.

  1. Claim or claim and restake. A claim supplies the position's payout, burn, and Merkle proof. The contract verifies the proof and settles the original stake plus its payout minus its burn. A direct user can claim this value, or an allocation strategy can atomically apply the available value to a newly authorized stake in an open round.

For an enabled allocation strategy with an eligible selected submission, Numerai's operator automatically invokes claim-and-restake; the user does not need to submit a transaction. The Claimable Stake value on Dashboard > V3 Stakes shows the resolved value that has not been rolled into a later stake. Claim All submits one or more bounded transactions through the allocation strategy and returns all of that value to the Privy embedded wallet.

Resolved positions do not remain unclaimed indefinitely. On the first scoring-resolution run after a position has remained unclaimed for more than seven days, Numerai automatically finalizes it. Finalization returns the releasable NMR to its staker and settles any burn instead of carrying it into a later stake. Users who interact with the staking contract directly should claim within that window if they want to control the timing themselves.

If a model has moved because one account was absorbed into another, its on-chain strategy still belongs to the old account. After finalizing such a position, Numerai automatically withdraws the released NMR from that orphaned strategy and transfers it to the model's current account strategy. If that account has no strategy, the NMR moves to its wallet instead. Numerai also drains idle NMR from an orphaned strategy that has position or funding history but no resolved claim. If the absorbed account staked directly from its old Privy wallet, Numerai forwards the finalized NMR from that wallet to the same current-account destination. For an otherwise unused strategy discovered only from its factory, Numerai moves the NMR only after it can recover a safe model-linked current account; until then, the NMR stays in the strategy rather than being sent to the disabled account's wallet.

Contract upgrades

Allocation strategies are tied to the staking contract where they were created. When Numerai upgrades a tournament to a new staking contract generation, an old strategy cannot restake directly into the replacement contract. After each old round resolves, Numerai finalizes every remaining claim on the old contract — including positions staked directly from a wallet — and sweeps each old strategy's full NMR balance into the owner's Numerai Wallet. If the account has a replacement strategy on the new contract, the swept NMR is then moved into it automatically; otherwise it stays in the legacy strategy owner's wallet, ready to fund a new strategy. If the old models now belong to another account, the NMR moves to its replacement strategy, or to its wallet when no strategy exists, instead of remaining with the absorbed source account. New automated stakes use the replacement strategy; users do not need to claim or move these migrating positions manually, and old strategies are re-checked every round so nothing is left behind.

Payouts, Burns, and Claims

For a v3 round, the payout calculation can be expressed as:

python
weighted_score = sum(score * multiplier for each payout score)
round_return = clip(payout_factor * weighted_score, -1, 1)
settlement = round_stake * round_return

payout = max(settlement, 0)
burn = max(-settlement, 0)
claimable = round_stake + payout - burn

For v3, payout_factor is 1, and the clip is ±1. The small legacy clip is therefore removed, but a position can still neither earn nor lose more than 100% of the NMR staked in that round.

Score types and multipliers are tournament and round configuration, not constants in the staking contract. Check the current round before modeling returns. The v3 announcement described the planned Signals transition as 4 × Alpha + 8 × MPC; it did not state that those multipliers also apply to Numerai. Multiplier changes must be read from the applicable round rather than inferred across tournaments.

INFO

Annual returns do not follow from the larger per-round bound alone. V3 divides a fixed capital budget across independently collateralized rounds, while payout score multipliers can also change. Model expected returns using the per-round allocation, the tournament's overlap count, and the actual multipliers for each round.

Merkle Claims

When a round resolves, Numerai publishes one model-scoped claim for each position. The staking contract does not store every claim on-chain. It stores the Merkle root and aggregate liabilities; v3StakeClaim returns the individual payout, burn, and proof needed to verify a leaf against that root.

Claims cannot be redirected between models or reused. The contract marks (round, staker, model) as claimed and decrements the round's remaining payout and burn amounts as claims are collected.

Burn Netting During Restaking

A direct claim returns:

text
releasable NMR = round stake + payout - burn

When a resolved claim is atomically restaked, its burn can be carried as deferred burn debt for that same model. A later payout for the same model offsets that debt before becoming a net payout. Deferred burn debt:

  • cannot be withdrawn or used as liquid NMR;
  • cannot fund a stake or count toward Compound mode;
  • cannot be netted against another model; and
  • remains backed by NMR held in the staking contract until it is offset or realized as a burn.

If you stop restaking and claim directly, the outstanding burn is finalized instead of being carried to a future position.

Reducing Stake

To reduce future exposure, lower the model's per-round stake. Setting it to zero is the v3 equivalent of requesting a full release: no new positions are opened, and existing positions become available as they resolve and are claimed.

NMR already staked in an active round cannot be removed early. Idle strategy NMR can be withdrawn to your Privy embedded wallet at any time. The legacy v2 stake release process does not apply to v3.

Withdrawing NMR

When you are ready to withdraw idle NMR, first withdraw it from the allocation strategy to your Privy embedded wallet from the V3 Stakes page. You can then use the embedded wallet controls to send NMR to an external Ethereum address. Active round stake remains locked until settlement.

V2-to-V3 Migration

The legacy off-chain continuous staking system is being replaced by Atomic Blockchain Staking. Once a tournament is migrated, legacy continuous staking pages and API mutations for increasing or decreasing stake are no longer used for that tournament.

This is what "no overlap leverage" means: v3 cannot lock the same NMR in more than one position at once. When comparing v2 and v3 returns, compare against the total capital deployed across all unresolved rounds, not against one round's stake.

During migration, Numerai provisions Privy embedded wallets and allocation strategies, then moves the old continuous stake into atomic positions as legacy rounds resolve. Each new position receives approximately 1/24 of the migrated Numerai or Crypto stake, or 1/64 of the migrated Signals stake. This gradually deploys the same capital across the tournament's overlap period without reusing it.

The current migration schedule is:

TournamentMigration startsExpected migration length
CryptoJune 16, 202624 business days
SignalsTBD64 business days
NumeraiTBD24 business days

Pending v2 decreases are reflected in the initial strategy settings. The Numerai Wallet remains accessible for wallet history and non-staking transfers, but it is no longer the place to manage new stakes after a tournament migrates.

API and Automation

API tokens that automate Atomic Blockchain Staking need the Manage web3 staking (web3_staking) scope. See API Keys for authentication and scope guidance.

The main GraphQL fields are:

  • v3StakeConfig returns staking contract metadata for a tournament.
  • v3StakeRound returns on-chain round status.
  • v3StakeAuth issues a staking authorization for an eligible selected submission.
  • v3StakeClaim returns the claim proof for an authenticated model and staker after a round resolves.
  • v3StakeClaims returns all resolved, unclaimed proofs and each claimableAmountWei for the authenticated account's models at a staker address, scoped to one tournament.

Important v3StakeRound fields include:

FieldMeaning
stateDerived round state such as open, closed, resolving, or resolved
openTime, closeTime, resolveTimeOn-chain round time boundaries
totalStakedNMR principal locked across the round's positions
totalPayoutAggregate positive payout in the posted settlement tree
remainingPayoutPayout reserve not yet consumed by claims
remainingBurnBurn amount not yet consumed by claims
merkleRootRoot used to verify individual model-scoped claims
payoutFactorDeprecated compatibility field. Populated from legacy contracts and null for upgraded contracts; read payout policy from the tournament round configuration
stakeThreshold, stakeCapDeprecated aliases for the same legacy contract value. Both are null for upgraded contracts; read stake policy from the tournament round configuration

Once a tournament's Atomic Blockchain Staking flag is enabled, the legacy V2 staking mutations for that tournament are disabled. Use the Atomic Blockchain Staking flow and staking v3 API fields instead.

WARNING

Authorizations are short-lived, nonce-protected, and tied to a particular selected submission. Do not cache and replay an old authorization after changing a submission or after another transaction consumes the staker's nonce.

Wallet Support

The website currently uses a Privy embedded wallet. Contract-aware users can interact with the deployed contracts directly, but must obtain valid stake authorizations and claim proofs from the API and are responsible for transaction gas and contract integration.

Networks and Contract Addresses

For Numerai Crypto (tournament 12), use the Crypto staking contract inventory. That tournament-specific page is the public source for its active route, retained settlement contracts, dormant networks, and verified explorer links.

USDC Staking

USDC staking is not currently implemented. It is planned for a future v3 update as a separate USDC staking pool. The v3 announcement described a target USDC payout factor around one tenth of the NMR payout factor.