Transactions

transfer-stake

Transfer stake ownership to another coldkey.

Hands the position itself to the destination coldkey: after this call that coldkey — not you — controls and can unstake those funds, so this is a transfer of value and is irreversible. Double-check the destination address. The stake stays on the same hotkey but can land on a different subnet, swapping through both pools (with slippage) when the netuids differ. Fails with TransferDisallowed when the subnet owner has disabled stake transfers on the origin or destination subnet. A spend-cap policy treats this as an unbounded spend and blocks it until the cap is raised. Use move_stake to re-delegate without changing owners.

Signer	Pallet	Wraps
`coldkey`	SubtensorModule	`SubtensorModule.transfer_stake`

Parameters

Parameter	Type	Required	Description
`dest_coldkey_ss58`	string	yes	Coldkey that becomes the new owner of the stake.
`hotkey_ss58`	string	yes	Hotkey the stake is held on (the validator backing the position).
`origin_netuid`	integer	yes	Subnet the stake currently sits on.
`dest_netuid`	integer	yes	Subnet the stake ends up on. When it differs from the origin, the position is swapped through both subnet pools, which can incur slippage on each leg.
`amount_alpha`	number \| `"all"`	yes	How much of the position to hand over (an explicit amount; `all` is not accepted).

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 transfer-stake \
  --dest-coldkey <ss58|name> \
  --hotkey <ss58|name> \
  --origin-netuid <int> \
  --dest-netuid <int> \
  --amount-alpha <amount|all> --dry-run
btcli tx transfer-stake \
  --dest-coldkey <ss58|name> \
  --hotkey <ss58|name> \
  --origin-netuid <int> \
  --dest-netuid <int> \
  --amount-alpha <amount|all> -w my_coldkey

Python

import bittensor as sub
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = sub.TransferStake(dest_coldkey_ss58="5F...", hotkey_ss58="5F...", origin_netuid=0, dest_netuid=0, amount_alpha=1.0)

async with sub.Client("finney") as client:
    plan = await client.plan(intent, wallet)   # fee, effects, policy — no submission
    result = await client.execute(intent, wallet)
    if not result.success:
        print(result.error.code, result.error.remediation)

Or build it by op name, as an agent would:

await client.execute_tool("transfer_stake", {...}, wallet)