Create a subscription on a list positions and make it active

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  $top	Integer	Query-String	The number of entries to return from the beginning of the collection
  Arguments	PositionRequest	Body	Arguments for the subscription request.
  ContextId	String	Body	The streaming context id that this request is associated with. This parameter must only contain letters (a-z) and numbers (0-9) as well as - (dash) and _ (underscore). It is case insensitive. Max length is 50 characters.
  Format	String	Body	Optional Media type (RFC 2046) of the serialized data updates that are streamed to the client. Currently only application/json and application/x-protobuf is supported. If an unrecognized format is specified, the subscription end point will return HTTP status code 400 - Bad format.
  ReferenceId	String	Body	Mandatory client specified reference id for the subscription. This parameter must only contain alphanumberic characters as well as - (dash) and _ (underscore). Cannot start with _. It is case insensitive. Max length is 50 characters.
  RefreshRate	Integer	Body	Optional custom refresh rate, measured in milliseconds, between each data update. Note that it is not possible to get a refresh rate lower than the rate specified in the customer service level agreement (SLA).
  ReplaceReferenceId	String	Body	Reference id of the subscription that should be replaced.
  Tag	String	Body	Optional client specified tag used for grouping subscriptions.

• Response Parameters

  View Response Codes

  Name	Type	Description
  ContextId	String	The streaming context id that this response is associated with.
  Format	String	The media type (RFC 2046), of the serialized data updates that are streamed to the client.
  InactivityTimeout	Integer	The time (in seconds) that the client should accept the subscription to be inactive before considering it invalid.
  ReferenceId	String	The reference id that (along with streaming context id and session id) identifies the subscription (within the context of a specific service/subscription type)
  RefreshRate	Integer	Actual refresh rate assigned to the subscription according to the customers SLA.
  Snapshot	PositionResponseListResult	Snapshot of the current data on hand, when subscription was created.
  State	String	This property is kept for backwards compatibility.
  Tag	String	Client specified tag assigned to the subscription, if specified in the request.

  HTTP Code	Description
  201	Created	Created
  400	Bad Request	Error Code Description InvalidClientId Indicates that the requested client id was invalid. InvalidInput An error was encountered when processing given input parameters. InvalidModelState Error code returned when model state is invalid. NoValidInput No valid input values passed. SubscriptionExceedesPositionsLimit Too many positions requested. Streaming updates are only allowed on a limited number of positions. UnsupportedSubscriptionFormat Error code returned when a subscription format that isn't supported by the publisher is requested.
  401	Unauthorized	Indicates that the request was rejected because the 'Authorization' header was missing in the request or contained an invalid security token.
  409	Conflict	Error Code Description SubscriptionLimitExceeded Error code returned when more than the maximum allowed number of subscriptions for a specified type, is exceeded.
  429	Too Many Requests	The request was rejected due to rate limit being exceeded.
  503	Service Unavailable	Service Unavailable.

  Close

• Streaming Response Parameters

  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.

• Request Example

  Request URL

  POST /port/v1/positions/subscriptions?$top=1

  Request Body

  {
    "Arguments": {
      "AccountGroupKey": "LZTc7DdejXODf-WSl2aCyQ==",
      "AccountKey": "LZTc7DdejXODf-WSl2aCyQ==",
      "ClientKey": "7m4I|vtYLUnEGg77o9uQhw==",
      "FieldGroups": [
        "PositionBase",
        "PositionView"
      ],
      "NetPositionId": "GBPUSD_FxSpot",
      "PositionId": "1019942425",
      "PriceMode": "RegularTradingHours"
    },
    "ContextId": "20241214061923237",
    "Format": "application/json",
    "ReferenceId": "P50730",
    "RefreshRate": 1000,
    "Tag": "PAGE1"
  }
  

• Response Example

  Response body

  {
    "Format": "application/json",
    "InactivityTimeout": 120,
    "ReferenceId": "P40038",
    "RefreshRate": 1000,
    "Snapshot": {
      "Data": [
        {
          "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
          }
        }
      ]
    },
    "State": "Active"
  }
  

• Streaming 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:00+00:00",
      "IsForceOpen": false,
      "IsMarketOpen": false,
      "LockedByBackOffice": false,
      "OpenPrice": 1.32167,
      "SpotDate": "2016-09-06T00:00:00+00:00",
      "Status": "Open",
      "Uic": 31,
      "ValueDate": "2017-05-04T00:00:00+00:00"
    },
    "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
    }
  }