Endpoint Parameters
-
Request parameters
Name Type Origin Description $skip Int Query-String Optional number of elements to skip. $top Int Query-String Optional number of elements to retrieve. FieldGroups PositionFieldGroup [] Query-String Optional. Specifies which data to return. Default is [PositionBase, PositionView] PriceMode PriceMode Query-String Optional. Specifies the prices to be used when returning price dependent values. Default is “RegularTradingHours”. -
Response Parameters
View Response CodesName Type Description Costs PositionCost Trading costs associated with opening/closing a position. DisplayAndFormat InstrumentDisplayAndFormat Information about the position instrument and how to display it. Exchange InstrumentExchangeDetails Information about the instrument's exchange and trading status. Greeks Greeks Greeks, only available for options, i.e. FX Options, Contract Options, and Contract Options CFDs. NetPositionId String The id of the NetPosition, to which this position is belongs. All positions in the same instrument have the same NetPositionId. PositionBase PositionStatic Static part of position information. PositionId String Unique id of this position. PositionView PositionDynamic Dynamic part of position information. UnderlyingDisplayAndFormat InstrumentDisplayAndFormat Information about the underlying instrument of the net position and how to display it. -
Request Example
Request URL
GET port/v1/positions/me/?$top=99&$skip=99&FieldGroups=Costs&PriceMode=RegularTradingHours
-
Response Example
Response body
{ "__next": "/openapi/port/....../?$top=1&$skip=1", "Data": [ { "NetPositionId": "GBPUSD_FxSpot", "PositionBase": { "AccountId": "192134INET", "Amount": 100000.0, "AssetType": "FxSpot", "CanBeClosed": true, "ClientId": "654321", "CloseConversionRateSettled": false, "ExecutionTimeOpen": "2016-09-02T10:25:00Z", "IsForceOpen": false, "IsMarketOpen": false, "LockedByBackOffice": false, "OpenPrice": 1.32167, "SpotDate": "2016-09-06", "Status": "Open", "Uic": 31, "ValueDate": "2017-05-04T00:00:00Z" }, "PositionId": "1019942425", "PositionView": { "Ask": 1.2917, "Bid": 1.29162, "CalculationReliability": "Ok", "CurrentPrice": 1.29169, "CurrentPriceDelayMinutes": 0, "CurrentPriceType": "Bid", "Exposure": 100000.0, "ExposureCurrency": "GBP", "ExposureInBaseCurrency": 129192.0, "InstrumentPriceDayPercentChange": 0.26, "ProfitLossOnTrade": -2998.0, "ProfitLossOnTradeInBaseCurrency": -2998.0, "SettlementInstruction": { "ActualRolloverAmount": 0.0, "ActualSettlementAmount": 10.0, "Amount": 10.0, "IsSettlementInstructionsAllowed": false, "Month": 7, "SettlementType": "FullSettlement", "Year": 2020 }, "TradeCostsTotal": 0.0, "TradeCostsTotalInBaseCurrency": 0.0 } } ] }