move-stake

Re-delegates an existing position without passing through the coldkey's free balance: the stake leaves the origin hotkey on the origin subnet and lands on the destination hotkey at the destination subnet. Moving within one subnet just changes which validator backs the stake. Moving across subnets swaps through both pools and can incur slippage on each leg.

Cross-subnet moves are slippage-protected by default: they compose move_stake_limit with a fill-or-kill price ratio. Same-subnet moves stay a single move_stake. Disable slippage_protection to submit the bare cross-subnet move_stake at any price.

Ownership stays with the signing coldkey — use transfer_stake to hand the position to another coldkey, or swap_stake when only the subnet changes. Pass all to move the entire origin position.

On root (netuid 0), a move takes principal only. Accrued basket yield stays owed on the origin until claim_root_with_hotkey. Pass claim=True to redeem this validator's whole entitlement first, then move, in one batch. That is not a proportional payout: the claim pays 100% of the basket, not a slice of the amount you move. Pass all with claim=True to move the live origin position after the claim: the follow-up uses u64::MAX, which the runtime caps to whatever root stake exists once the claim has flushed pending basket deposits and restaked the payout.

Parameters

Address parameters (--hotkey, --coldkey, --dest, ...) accept a raw ss58 address, an address-book or proxy-book name, or a local wallet/hotkey name.

CLI

Preview with --dry-run (shows fee, effects, and policy result without submitting), then submit:

btcli tx move-stake \
  --origin-hotkey <ss58|name> \
  --origin-netuid <int> \
  --dest-hotkey <ss58|name> \
  --dest-netuid <int> \
  --amount-alpha <amount|all> --dry-run
btcli tx move-stake \
  --origin-hotkey <ss58|name> \
  --origin-netuid <int> \
  --dest-hotkey <ss58|name> \
  --dest-netuid <int> \
  --amount-alpha <amount|all> -w my_coldkey

Python

import bittensor as bt
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = bt.MoveStake(origin_hotkey_ss58="5F...origin", origin_netuid=1, dest_hotkey_ss58="5G...destination", dest_netuid=2, amount_alpha=1.0)

sub = bt.Subtensor()
plan = sub.plan(intent, wallet)   # fee, effects, policy — no submission
result = sub.execute(intent, wallet)
if not result.success:
    print(result.error.code, result.error.remediation)

(bt.Subtensor is also the async client — async with bt.Subtensor() as client: — see The client.) Or build the intent by op name, as an agent would:

result = sub.execute_tool("move_stake", {...}, wallet)

On-chain implementation

Every file is browsable under /code exactly as built into the runtime, or as plain text under /code/raw/<path> (index: /code/index.json).