GetAccountPositions
Last updated
Last updated
Category: User Permissions: Operator, Trading, AccountReadOnly, Manual Trader Call Type: Synchronous
Retrieves a list of positions (balances) for a specific user account running under a specific Order Management System. The trading day runs from UTC Midnight to UTC Midnight.
Users with Trading or AccountReadOnly permission must specify an account ID with which they're associated on the Order Management System. Users with Operator permission can specify other accounts.
Key | Value |
---|---|
The response returns an array of one or more positions for the account. This example response has returned two positions.
Key | Value |
---|---|
AccountId
integer. The ID of the authenticated user’s account on the Order Management System for which positions will be returned.
OMSId
integer. The ID of the Order Management System to which the user belongs. A user will belong only to one OMS.
Include Pending
boolean . To know if will include pending positions
omsId
Integer. The ID of the Order Management System (OMS) to which the user belongs. A user will only ever belong to one Order Management System. Note the change in capitalization from the request.
accountId
integer. Returns the ID of the user’s account to which the positions belong. Note the change in capitalization from the request.
productSymbol
string. The symbol of the product on this account’s side of the trade. For example: BTC — BitCoin USD — US Dollar NZD — New Zealand Dollar Many other values are possible depending on the nature of the trading venue.
productId
integer. The ID of the product being traded. The system assigns product IDs as they are entered into the system. Use GetProduct to return information about the product by its ID.
amount
real. Unit amount of the product; for example, 10 or 138.5.
hold
real. Amount of currency held and not available for trade. A pending trade of 100 units at $1 each will reduce the amount in the account available for trading by $100 and produce a $100 hold. Amounts on hold cannot be withdrawn while a trade is pending.
pendingDeposits
real. Deposits accepted but not yet cleared for trade.
pendingWithdraws
real. Withdrawals acknowledged but not yet cleared from the account. Amounts in PendingWithdraws are not available for trade.
totalDayDeposits
real. Total deposits on today’s date. The trading day runs between UTC Midnight and UTC Midnight.
totalMonthDeposits
real. Total deposits for the month as of today's date.
totalYearDeposits
real. Total deposits for the year as of today's date.
totalYearDepositNotional
real. Yearly amount for deposit of crypto-currencies. It is usually calculated as value = (Amount * Bid/Ask Price). 10 BitCoin each at $6700 equals $67000.
totalDayWithdraws
real. Total withdrawals on today’s date. The trading day runs between UTC Midnight and UTC Midnight.
totalMonthWithdraws
real. Total withdrawals during this month to date. The trading day runs between UTC Midnight and UTC Midnight — likewise a month begins at UTC Midnight on the first day of the month.
totalYearWithdraws
real. Total withdrawals during the current year to date.
totalYearWithdrawNotional
real. Yearly withdrawals for crypto-currencies. It is usually calculated as value = (Amount * Bid/Ask Price). 10 BitCoin each at $6700 equals $67000.