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 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. After you submit a staking transaction, the page keeps it visibly pending through on-chain confirmation and backend indexing, then refreshes the activity feeds, positions, claims, strategy status, and balances without a page reload. If indexing is delayed, use Retry refresh or the always-available Refresh button beside Stake Activity; the last confirmed values remain visible until the refresh succeeds.

Allocation Strategies

An account has one allocation strategy per tournament allowing you to configure your staking preference for each model in a tournament. Each model's configuration includes:

  • a per-round stake amount
  • a staking mode ("constant" or "compound")
  • a flag to enable or disable automation

Per-round stake

This is the amount of NMR you lock up each round. If you have a target "Total Value Locked" of TVL and a tournament has R concurrently unresolved rounds, set the per-round stake to S = TVL / R.

Numerai requires at least 0.1 NMR per round before it issues a V3 stake authorization or invokes an allocation strategy.

The dashboard also requires at least 0.1 NMR when saving an enabled model configuration in either payout mode. Increase an older setting below this minimum to at least 0.1 NMR, or disable the model. Disabling is always allowed. Adding funds without changing model settings does not require updating an older stake amount.

TournamentConcurrent Rounds (R)Per-round Stake S
Numerai64TVL / 64
Signals64TVL / 64
Crypto24TVL / 24

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

The setting used for a round is read while Numerai processes that round's selected submission. See Round Lifecycle for how later setting changes and re-uploads are handled.

Staking Modes

Atomic Blockchain Staking supports two automated modes:

  • Constant tries to stake exactly your configured per-round stake and no more. If you don't have enough NMR available, this mode will stake however much you have available, provided it meets the 0.1 NMR minimum.

  • Compound tries to stake exactly your per-round stake until you start receiving payouts, then it will compound those payouts into future stakes. If you don't have enough NMR available, this mode will stake however much you have available, provided it meets the 0.1 NMR minimum.

Automation Flag

This flag allows you to quickly switch models off, effectively setting the model's per-round stake to 0 and telling Numerai to stop invoking a model. Resolved payouts and burns will continue to settle automatically, but no future stakes will be placed on the model.

Idle Strategy Balance

Allocation strategies are also capable of holding NMR. If you start staking, the idle strategy balance must contain some NMR that can be used for staking. When you receive payouts under a "constant" staking mode, any settlement value above your configured per-round stake is returned to your idle balance and can be used to "top-up" your models if they burn. A model that settles below its per-round stake puts that value into its next stake instead of into the idle balance. Under a "compound" staking mode, payouts are rolled into future stakes rather than into the idle balance. Each invocation compounds only the newest settled claim, so if claims pile up, for example while a model is paused, the older ones are finalized into the idle balance after the seven-day grace period.

Round Lifecycle

When a round opens, Numerai creates the round both in our database and on-chain. Throughout the open submission window, Numerai polls selected submissions and operates your allocation strategy according to your saved per-model stake settings. Numerai only invokes your strategy when you have:

  • an on-time submission for the round
  • at least 0.1 NMR available to stake

Your model's strategy settings are read when its selected submission is processed. Changing those settings later in the same open window does not change an automatic stake already placed for that round. Re-upload to make the latest selected submission eligible for processing again. If an enabled position is already on-chain, the re-upload updates its submission hash but does not resize the NMR already locked.

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

  1. Create and open the round. Numerai creates the round both in an off-chain database and in the on-chain contract. The on-chain round details include the 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 contract to cover payouts. The contract marks the round resolved and ensures there is enough NMR to fund payouts. At this point, the resolved stakes are "claimable" via "stake claims".

  5. Claim stake or claim and restake. A "stake claim" (available through our API) supplies the position's payout, burn, and Merkle proof. The contract verifies the proof and settles the original stake net payout or burn. Stake claims are processed one of 2 ways:

    • The Claim All button on the Dashboard > V3 Stakes page will submit allocation strategy transactions to return the Claimable Stake value to you.
    • Numerai will automatically claim and restake it for you via your allocation strategy in a later round. Selected submissions are processed in arrival order. A model that cannot be funded is retried while the round remains open.

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 settles out the stake value net payout or burn and returns the remaining NMR to its staker. 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 transfers the released NMR from that orphaned strategy 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.

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.

Numerai "Classic" Tournament: Ender-60 transition

Numerai "Classic" is transitioning from legacy staking and payouts on Ender-20 to Atomic staking and payouts on Ender-60 using multipliers 3 × CORR60 + 15 × MMC60, starting at round 1343. Running a historical simulation across recent rounds shows the following yield distributions after accounting for the 1/64th per-round stake, payout factor of 1, and longer compounding horizon:

Histogram comparing legacy Ender-20 and Atomic Ender-60 participant returns
This is a historical simulation across rounds 1172-1260 for informational purposes only. This is not an advertisement to stake. Historical performance is not indicative of future returns. Users with different expectations should not stake.

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.

WARNING

If a wallet or strategy transaction is submitted but confirmation is delayed, do not submit it again. Use Check status in Stake Activity to query the transaction receipt. The pending transaction remains available after leaving or reloading the page until it confirms or reverts.

Leaving the V3 Stakes page does not cancel a submitted transaction. If a navigation warning appears, continuing means the page will stop monitoring the transaction and refreshing staking data. The transaction may still confirm on-chain, and balances or activity may appear stale until you return and refresh or reload the page. Browsers may use their own generic warning when you reload or close the tab.

V2-to-V3 Migration

Migrating from the current continuous staking protocol to the new Atomic Blockchain Staking protocol is complicated. So let’s break down what that will look like:

  • When a tournament starts the migration, the legacy off-chain staking system will be no longer accessible. You will no longer be able to increase or decrease your stake through the normal website page / APIs. Instead, we will replace the staking UI with a new web3-native staking page that can create and control an allocation strategy through a non-custodial wallet solution backed by Privy.

  • Your legacy Numerai Wallet will still be accessible at https://numer.ai/wallet and you can still withdraw from it, but but links to it will be removed and it will no longer be used for staking.

  • Your stake will begin migrating from your legacy Numerai Wallet to the new stake contracts. The current system keeps your staked NMR in your wallet and simply uses off-chain accounting to earmark that NMR as staked and unavailable. The new system will need to actually lock up that NMR on the blockchain, so we will execute on-chain transactions to move that NMR from your Numerai wallet into the new staking contracts.

  • New rounds will now lock up a smaller portion of stake. When an old “continuous staking” round resolves, we transfer 1/24th of your staked NMR into the new stake contract and lock that up (or lock up just 1/64th in the case of the Numerai Classic transition). This is because there are 24 possible overlapping rounds and your current stake must cover all 24 (64 for classic) new rounds, only the small fraction of your NMR that needs to be locked up will be transferred each round.

  • You don’t need to do anything during the migration. We will handle provisioning your wallets and allocation strategies. We will also handle the migration of your staked NMR from your Numerai Wallet into your allocation strategy.

How Returns Are Calculated

The return percentages on your model and account pages are profit over the NMR you committed. Profit is the payouts and burns of every round that settled in the window. Committed NMR counts only NMR that was actually locked in a position: what was locked when the window opened, plus, for each round, whatever its stake exceeded what your earlier positions had already released. Idle NMR in your allocation strategy is never counted, because it is not staked and earns nothing. Restaking your own settled NMR is therefore not new capital in either mode, whether Compound rolls it straight into the next round or it waits in the strategy first. You only commit new capital when you want a position larger than your settlements can fund.

A few consequences are worth knowing:

  • Loading a stake takes a full overlap period. Staking 1 NMR per round means 64 NMR is deployed on Numerai or Signals, and 24 NMR on Crypto, once every round is live, and no round pays out until the first one settles.
  • Compound mode restakes each settlement, so it earns more on the same committed NMR than Constant mode, which leaves the released value idle. Over 260 rounds at a steady 10% per round, a Numerai or Signals stake returns about 41% in Constant mode and about 47% in Compound mode. The shorter Crypto overlap settles more often over the same 260 rounds, returning about 108% and about 181%.
  • Reusing settled NMR does not raise your basis. If you stake for a while, stop until your positions settle, then stake again from those settlements, the resumed stakes are measured against capital you funded once. That does not make a pause free: over a fixed 3-month or 1-year window, the rounds you skip pay nothing into it, and in Compound mode they stop compounding as well.

Lowering Per-round stake in Compound mode does not reduce your exposure while your settlements exceed the new value, because Compound stakes max(per-round stake, released value) and funds that from the settlement itself. Withdrawing idle NMR does not change it either: idle only tops a stake up when the settlement falls below Per-round stake. To reduce exposure, switch to Constant mode, which stakes exactly Per-round stake and leaves the rest of each settlement idle for you to withdraw.

During migration, Numerai provisions Privy embedded wallets and allocation strategies, then moves the old continuous stake into atomic positions as legacy rounds resolve. Each resolved legacy round releases one share of the migrated stake, counting one share for each legacy round that still holds your stake at risk when the migration starts: about 1/24 on Numerai and 1/64 on Signals for a model staked in every round, and a larger share for a model that skipped rounds, which has fewer such rounds. Numerai's legacy rounds ran on the 20-day horizon, so a continuously staked model releases over 24 rounds while its atomic per-round stake stays TVL / 64. Once a tournament's legacy rounds have all resolved, as on Crypto, any stake still on the legacy ledger moves in a single release. This gradually deploys the same capital without reusing it.

The current migration schedule is:

TournamentMigration startsExpected migration length
CryptoJune 16, 202624 business days
SignalsTBD64 business days
NumeraiAugust 28, 202624 business days

At cutover, pending v2 changes are retired before stake migration begins. Every pending increase or decrease is first reflected in the initial allocation strategy settings. A pending decrease is not released to the Numerai Wallet; the legacy request itself is then cancelled. The resulting v2 stake moves to the strategy over the migration schedule and can be managed through Atomic Blockchain Staking. 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

Each tournament publishes its own contract inventory. Those tournament-specific pages are the public source for active routes, 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.

FAQ

Does lower leverage mean lower payouts?

Yes and no. Staking leverage is generated from having a continuous stake with overlapping rounds. In Numerai and Crypto, there are 24 overlapping rounds, but the 5% clip reduces effective leverage to just 1.2x. In addition, Numerai and Crypto have low payout factors, which reduces maximal payouts / burns to something closer to 1-2% per round. This almost never hits the clip value and thus experienced leverage is actually lower than 1, so there is a lot of head room to actually increase payouts when we transition staking systems.

For Signals, the there are 64 overlapping rounds with a 3.5% clip. This nearly doubles the effective leverage to 2.24x. Signals also has a higher payout factor which brings maximal payouts / burns closer to 7% - this hits the clip value far more often, meaning Signals actually does experience this higher leverage. When we transition to the new staking system, there is no leverage. This means maximal payouts and burns will be reduced to 100% per round.

Can I bring my own wallet?

Yes. These contracts are deployed on the blockchain, so anyone will be allowed to interact with them in a de-centralized way. You can manage your own stake directly or instantiate your own allocation strategy. At this time, Numerai will roll out the new staking system using the non-custodial wallet solution to aid in the migration. Once we've completely transitioned, we will be able to build in support for other wallet solutions - such as Meta Mask - to be used directly on our website.

What if I have a pending stake release?

When the transition starts, we will disable future stake changes, snapshot your current stake settings / at-risk values, and instantiate a new Allocation Strategy contract based on those settings. If you've decreased or drained your stake, those settings will be reflected when we instantiate your allocation strategy and released stake will begin showing up in your strategy. You will simply need to claim ownership of the strategy and re-allocate or withdraw those funds as you wish.

When will this happen and how long will it take?

  • Numerai Crypto begins migrating on June 16 and will take 24 business days to complete.

  • Numerai ("classic") begins migrating August 28 and will take 64 business days to complete because it is also switching to the ender_60 target.

  • Numerai Signals migration is TBD.

Will NMR be burned immediately or will there be some netting?

NMR will not be burned immediately when using stake automation and the claim + re-stake flow. Instead, when a model continues re-staking, burns can simply accumulate on a per-model basis and be netted out by future payouts. If a model stops staking or manually claims their stakes without immediately re-staking, the NMR must necessarily be burned.

If we're set to compounding now, we wont be receiving spendable tokens at any point in time during the transition, right?

Correct (if you continue submitting normally and don't have any pending drains). As rounds resolve, we will automatically transition a portion of your staked tokens to be immediately staked on new submissions until your existing stake is evenly split across all ongoing rounds and fully locked up in the new staking contract.

Does it matter if a staked slot is not submitting predictions?

If a staked slot is no longer submitting, that stake is already unlocked, idle balance. In ABS, idle balances will now pool in your allocation strategy contract. Once you claim ownership of that strategy contract, you can withdraw tokens into your wallet or stake that balance as you wish.

How will releases be handled?

The "release" equivalent in ABS is just setting your per-round stake to 0. Resolved stakes can then be claimed back into your allocation strategy contract.

Will it now be predictable where the tokens will be coming from?

Payouts have always come from our hot wallet and this will still be true. Instead of us depositing NMR directly into your Numerai Wallet upon release settlement, we will now transition resolved payout NMR into the staking contract to be used for claims and re-staking. If you continue submitting normally, your NMR will stay in the staking contract. If you stop submitting and simply claim all of your resolved stakes, that NMR comes back from the staking contract into your strategy contract. Then you can withdraw into your wallet and send it where you please.