Change a paper position
arena_editChanges one of the caller's open paper positions. Use after arena_state for the id; to end a position use arena_close. kind: claim pays the fees waiting to cash; compound puts them back into the rungs; add puts amountUsd more in, in the position's shape; withdraw takes pct of every rung out to cash; rebalance lays the band again at the price now from plan; auto sets the autopilot rules (take profit, stop loss, re-lay, harvest, compound), run for you like the live pilot. Returns: position (as it stands after the change), cashUsd. Behavior: writes to the account at the pool's price now; the field the kind needs is checked before anything changes. Heavy: costs 3 units and a heavy slot. Errors: refused when the id is not one of the caller's open positions, cash is short for an add, or the kind's field is missing (amountUsd for add, pct for withdraw, plan for rebalance, rules for auto).
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": {
"id": "<id>",
"kind": "<kind>"
},
"name": "arena_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The position's id, from arena_state or arena_open. | |
| pct | No | With kind withdraw: the percent of every rung to take out to cash, 1 to 99. | |
| kind | Yes | What to do: claim, compound, add, withdraw, rebalance or auto. | |
| plan | No | With kind rebalance: the new band and shape, laid at the price now. | |
| rules | No | With kind auto: the autopilot rules; every rule at 0 or false turns the autopilot off. | |
| amountUsd | No | With kind add: play dollars to put in, from cash. |