Create a subscription on trade messages

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  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	TradeMessageResponseListResult	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 InvalidModelState Error code returned when model state is invalid. InvalidRequest Invalid request. 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
  Data	TradeMessageResponse	The type of data transported by the DomainEvent instance (e.g. price update, position list update etc.).
  PartitionNumber	Integer	The partition number if this DomainEvent is a partition.
  ReferenceId	String	Client specified id, which is sent back to the client with every data update.
  Timestamp	UtcDateTime	The UTC date and time of the event.
  TotalPartitions	Integer	The total number of partitions if this DomainEvent is a partition.

• Request Example

  Request URL

  POST /trade/v1/messages/subscriptions

  Request Body

  {
    "ContextId": "20240424104312865",
    "ReferenceId": "TM13716",
    "Tag": "PAGE1",
    "RefreshRate": 5,
    "Format": "application/json"
  }
  

• Response Example

  Response body

  {
    "Snapshot": {
      "Data": [
        {
          "MessageId": "345322",
          "MessageType": "PriceAlert",
          "DateTime": "2014-12-12T09:17:12Z",
          "DisplayType": "Default",
          "MessageHeader": "Price Alert",
          "MessageBody": "Price alert was triggered on EURUSD",
          "IsDiscardable": false
        }
      ]
    },
    "ContextId": "20240424104312865",
    "ReferenceId": "TM13716",
    "Tag": "PAGE1",
    "InactivityTimeout": 120,
    "RefreshRate": 800,
    "Format": "application/json",
    "State": "Active"
  }
  

• Streaming Response Example

  Response body

  ""