Position Information
AdjustVPosition
Adjusts a virtual bot position by processing a simulated order using the defined specifications. Works similarly to PlaceExitLongOrder/PlaceExitShortOrder, but will NOT create a real order; only simulated!
Syntax: AdjustVPosition(price, amount, [ positionId ])
Return type: Void
price
Number
True
Number,UserPositionContainer
amount
Number
True
Number,UserPositionContainer
positionId
String
False
NewGuid,Text,Load
CloseVPosition
Closes a virtual bot position entirely by processing a simulated order using the defined specifications. Works similarly to DoExitPosition and PlaceExitPositionOrder, but will NOT create a real order; only simulated! Use this to "clean up" bot positions if required.
Syntax: CloseVPosition(price, [ positionId ])
Return type: Void
price
Number
True
Number,UserPositionContainer
positionId
String
False
NewGuid,Text,Load
CreatePosition
Creates a bot position by processing a simulated order using the defined specifications. By doing this, profit/loss and position details can be used by the script. Use the returned position ID with PositionContainer() to extract position data.
Syntax: CreatePosition(direction, price, amount, [ market ], [ leverage ], [ positionId ])
Returns the position ID.
Return type: String
direction
Enum
True
PositionLong,PositionShort
price
Number
True
Number,UserPositionContainer
amount
Number
True
Number,UserPositionContainer,MaxExitLongAmount,MaxExitShortAmount
market
String
False
InputAccountMarket,InputMarket,InputPriceSourceMarket,PriceMarket
leverage
Number
False
Input,Number,Leverage
positionId
String
False
NewGuid,Text,Load
GetAllOpenPositions
Gets all open positions and returns them as PositionContainers.
Syntax: GetAllOpenPositions()
Returns an array of PositionContainers.
Return type: Dynamic
GetPositionAmount
Gets the total amount open in a specific position.
Syntax: GetPositionAmount([ positionId ])
Returns the total amount open in a specific position.
Return type: Number
positionId
String
False
Load
GetPositionDirection
Gets the direction of a specific position.
Syntax: GetPositionDirection([ positionId ])
Returns PositionLong, PositionShort or NoPosition.
Return type: Enum
positionId
String
False
Load
GetPositionEnterPrice
Gets the average enter price of an open position.
Syntax: GetPositionEnterPrice([ positionId ], [ includeClosed ])
Returns the average enter price.
Return type: Number
positionId
String
False
Load
includeClosed
Boolean
False
True,IsTrue,False,IsFalse,Or,Branch,Equals,IsBiggerThan,IsSmallerThan,IsBiggerOrSmallerThan,IsAnyOrderOpen,IsOrderFilled,IsOrderOpen,IsTradeAmountEnough
GetPositionMarket
Gets the market of an open position.
Syntax: GetPositionMarket([ positionId ])
Returns the account, market & leverage as a single string.
Return type: String
positionId
String
False
Load
GetPositionProfit
Gets the total realized plus unrealized profit of a specific position.
Syntax: GetPositionProfit([ positionId ], [ targetPrice ])
Returns the total realized plus unrealized profit of a specific position. On spot/margin the result will be in the quote currency. For leverage its in the underlying currency.
Return type: Number
positionId
String
False
Load
targetPrice
Number
False
GetBuyPrices,GetSellPrices,GetOpenPrices,GetHighPrices,GetLowPrices,GetClosePrices,GetHighLowPrices,GetHighLowClosePrices,GetOpenClosePrices,GetOpenHighLowClosePrices,GetBodyHighPrices,GetBodyLowPrices
GetPositionROI
Calculates the ROI based on used margin and unrealized + realized profits.
Syntax: GetPositionROI([ positionId ], [ targetPrice ])
Returns the ROI as a percentage.
Return type: Number
positionId
String
False
Load
targetPrice
Number
False
GetBuyPrices,GetSellPrices,GetOpenPrices,GetHighPrices,GetLowPrices,GetClosePrices,GetHighLowPrices,GetHighLowClosePrices,GetOpenClosePrices,GetOpenHighLowClosePrices,GetBodyHighPrices,GetBodyLowPrices
IsPositionClosed
Checks whether or not a position is closed.
Syntax: IsPositionClosed([ positionId ])
Returns true if position is closed, otherwise false.
Return type: Boolean
positionId
String
False
Load
LongAmount
Gets the total amount open in a long position.
Syntax: LongAmount([ market ])
Returns the total amount open in a long position.
Return type: Number
market
String
False
InputAccountMarket,InputMarket,InputPriceSourceMarket,PriceMarket
PositionContainer
Gets all the information from the open bot position.
Syntax: PositionContainer([ positionId ], [ includeClosed ])
Returns an array with position information.
Return type: Dynamic
positionId
String
False
Load
includeClosed
Boolean
False
True,IsTrue,False,IsFalse,Or,Branch,Equals,IsBiggerThan,IsSmallerThan,IsBiggerOrSmallerThan,IsAnyOrderOpen,IsOrderFilled,IsOrderOpen,IsTradeAmountEnough
ShortAmount
Gets the total amount open in a short position.
Syntax: ShortAmount([ market ])
Returns the total amount open in a short position.
Return type: Number
market
String
False
InputAccountMarket,InputMarket,InputPriceSourceMarket,PriceMarket
Last updated