identity_transfer
Transfers an agent identity NFT to a new owner in the ERC-8004 registry, clearing the agent wallet association so you can reassign a wallet afterward.
Instructions
Transfer an agent identity NFT to a new owner in the ERC-8004 identity registry. This clears the agent wallet association — run identity_set_wallet after if needed. Requires an unlocked wallet.
Tip: call earning_opportunities to see how to put your assets to work.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agentId": "<agentId>",
"recipient": "<recipient>"
},
"name": "identity_transfer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fee | No | Fee preset ("low", "medium", "high") or micro-STX amount. Optional. | |
| agentId | Yes | Agent ID (token ID) to transfer | |
| recipient | Yes | Stacks address of the new owner | |
| sponsored | No | Use sponsored transaction relay so a relay service pays fees instead of your wallet. Requires SPONSOR_API_KEY env var or wallet-level sponsorApiKey. |