Get Signal Bot Positions (MCP Tool)
Description
Get live positions from the same data source as the cabinet Positions view. rows is an array of strategies with _id, status, type (false Long, true Short), pairCode, price, lastPrice, currentPosition, totalProfitLoss, and profileStrategies. currentTrader has code, timezone and locale. actions maps cabinet action names to {link, isGranted}; those links are for the UI and may contain __id__, so use dedicated API tools for trading actions. More strategy fields and nullable values may be present.
In each row, currentPosition is price PnL in percentage points (5 means +5%), not a position amount. price is the entry reference price in the pair quote currency; after fills it is the USD-entry-volume-weighted average of the profile entry prices, including DCA/scale-in fills. While open, lastPrice is the comparison price. The cabinet calculates displayed USD PnL as max(totalEntryVolume - totalExitVolume, 0) * currentPosition / 10000 + totalProfitLoss / 10000; volumes are USD cents and totalProfitLoss is in 1/10000 USD. This formula gives PnL, not the current market value or quantity. Contract and inverse markets need exchange-specific quantity conversion.
Required permission: signal_bot:read.
Show live positions of Signal Bot bot-code.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"description": "Code that identifies the bot, available in bot list results."
}
},
"required": [
"code"
],
"additionalProperties": false
}