Close my net exposure to a coin across exchanges
close_net_exposureBring the net position in one coin across every exchange (long minus short) to zero, or to keep_fraction of it, by closing the larger side with reduce-only market orders, largest position first. It never opens a position: being long on one exchange and short on another stays as a hedge. Use when the person asks to hedge, flatten or cut their overall exposure to a coin. Not for one position (use close_position). Third-party apps reduce only positions they opened. Input: symbol, optional keep_fraction. A close cannot be undone. Next: get_my_positions (its net).
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": {
"symbol": "<symbol>"
},
"name": "close_net_exposure"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | No | real (exchange accounts) or sandbox; needed only when the coin is held in both | |
| symbol | Yes | Base coin, e.g. BTC | |
| keep_fraction | No | How much of the net to keep, a fraction: 0 = net flat (the default), 0.5 = halve it |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | Yes | real or sandbox | |
| closes | Yes | Each reduce-only close, largest position first | |
| symbol | Yes | Base coin | |
| deprecation | No | Present only while this tool is deprecated: replacement, removal_date, changelog | |
| net_after_base | Yes | Net after, in the base coin (e.g. BTC), not USD, read back from the venues | |
| net_before_base | Yes | Net before, in the base coin (e.g. BTC), not USD |