Get a single position

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  AccountGroupKey	AccountGroupKey	Query-String	The key of the account group to which the net positions belongs.
  AccountKey	AccountKey	Query-String	The key of the account to which the net positions belongs.
  ClientKey	ClientKey	Query-String	The key of the client to which the net positions belongs.
  FieldGroups	PositionFieldGroup []	Query-String	Specifies which data to return. Default is [PositionBase,PositionView]
  PositionId	String	Route	Unique ID of the position.

• Response Parameters

  View Response Codes

  Name	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.

  HTTP Code	Description
  200	OK	OK
  400	Bad Request	Error Code Description InvalidClientId Indicates that the requested client id was invalid. PositionIdNotSpecified Position not specified.
  401	Unauthorized	Indicates that the request was rejected because the 'Authorization' header was missing in the request or contained an invalid security token.
  429	Too Many Requests	The request was rejected due to rate limit being exceeded.
  503	Service Unavailable	Service Unavailable.

  Close

• Request Example

  Request URL

  GET /port/v1/positions/167968381?AccountGroupKey=stringValue&AccountKey=01b64edf-da03-4145-bf33-ae21527d4c86&ClientKey=493b43a5-fe85-4d1f-9071-dd4a9d4e42a4&FieldGroups=DisplayAndFormat

• Response Example

  Response body

  {
    "NetPositionId": "GBPUSD_FxSpot",
    "PositionBase": {
      "AccountId": "192134INET",
      "Amount": 100000,
      "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-06T00:00:00Z",
      "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,
      "ExposureCurrency": "GBP",
      "ExposureInBaseCurrency": 129192,
      "InstrumentPriceDayPercentChange": 0.26,
      "ProfitLossOnTrade": -2998,
      "ProfitLossOnTradeInBaseCurrency": -2998,
      "SettlementInstruction": {
        "ActualRolloverAmount": 0,
        "ActualSettlementAmount": 10,
        "Amount": 10,
        "IsSettlementInstructionsAllowed": false,
        "Month": 7,
        "SettlementType": "FullSettlement",
        "Year": 2020
      },
      "TradeCostsTotal": 0,
      "TradeCostsTotalInBaseCurrency": 0
    }
  }