OpenAPI

Messages to indicate events related to Security Transfers. 

Additional Fields

Name

Type

Description

Available

ClientSecuritiesTransferIdIntUnique reference number against the transfer initiated by a clientAlways
CurrentStateEnum

Master Transfer Status

  • NewRequest
  • ContactingCounterparty
  • Processing
  • PartiallyCompleted
  • TransferCompleted
  • TransferCancelled
  • UnknownUnspecified
Always
DirectionEnum

Transfer Type

  • In
  • Out
  • UnknownUnspecified
Always
ExchangeSecurityTransfers.AgreedSettlementDateDatetimeContractual settlement dateIf provided.
ExchangeSecurityTransfers.AgreedTradeDateDatetime

Contractual trade date  

If provided.
ExchangeSecurityTransfers.CurrentFlowStateString

Current flow of each transfer

Always
ExchangeSecurityTransfers.HaveInsufficientPositionsboolFlag if client hold insufficient position of requested instrument Always
ExchangeSecurityTransfers.TransferCloseDateUtcDateTimeTransfer close dateAlways
ExchangeSecurityTransfers.SecurityTransfers.PriceDecimalPrice at which instrument demanded to moveAlways
ExchangeSecurityTransfers.SecurityTransfers.QuantityDecimal

Transfer quantity requested

Always
ExchangeSecurityTransfers.SecurityTransfers.SymbolCodestringSymbol of the instrumentAlways
ExchangeSecurityTransfers.SecurityTransfers.TradeSettlementDateUtcDateTime

Trade settlement date   

If provided.
IsClientNotificationRequiredbool

Client notification on stock transfer status back to client is required or not            

Always
TransferCreatedDateUtcDateTime

The Date when SAXO created the transfer

Always
TransferReceiveDateUtcDateTimeThe Date when SAXO received the transfer requestAlways


Sample message:

An example for security transfer event message:

// Announcement

{
  "__count": 2,
  "Data": [
    {
      "AccountId": "65500/0907269EUR",
      "AccountKey": "8igAwavcMhHGj9ICeQJWIvN7MBQEOB|Ijhtlwy775Hk=",
      "ActivityTime": "2023-02-09T22:26:39.886666Z",
      "ActivityType": "SecurityTransfers",
      "ClientId": "9321331",
      "ClientKey": "IlHRzqsyBIL2Q4jMPESiww==",
      "ClientName": "******",
      "ClientSecuritiesTransferId": 397326,
      "CurrentState": "NewRequest",
      "Direction": "In",
      "ExchangeSecurityTransfers": [
        {
          "CurrentFlowState": "Positions Tranfer Request",
          "HaveInsufficientPositions": false,
          "SecurityTransfers": [
            {
              "Price": 16.2100653,
              "Quantity": 30000,
              "SymbolCode": "UCG:xmil",
              "TradeSettlementDate": "2019-04-15"
            }
          ],
          "TransferCloseDate": "2023-02-09"
        }
      ],
      "IsClientNotificationRequired": true,
      "OwnerId": "9081948",
      "SequenceId": "1200612394",
      "TransferCreatedDate": "2023-02-09",
      "TransferReceiveDate": "2023-02-09"
    },
    {
      "AccountId": "65500/0907269EUR",
      "AccountKey": "8igAwavcMhHGj9ICeQJWIvN7MBQEOB|Ijhtlwy775Hk=",
      "ActivityTime": "2023-02-09T22:26:39.886666Z",
      "ActivityType": "SecurityTransfers",
      "ClientId": "9321331",
      "ClientKey": "IlHRzqsyBIL2Q4jMPESiww==",
      "ClientName": "******",
      "ClientSecuritiesTransferId": 397326,
      "CurrentState": "TransferCompleted",
      "Direction": "In",
      "ExchangeSecurityTransfers": [
        {
          "CurrentFlowState": "Completed",
          "HaveInsufficientPositions": false,
          "SecurityTransfers": [
            {
              "Price": 16.2100653,
              "Quantity": 30000,
              "SymbolCode": "UCG:xmil",
              "TradeSettlementDate": "2019-04-15"
            }
          ],
          "TransferCloseDate": "2023-02-09"
        }
      ],
      "IsClientNotificationRequired": true,
      "OwnerId": "9081948",
      "SequenceId": "1200612422",
      "TransferCreatedDate": "2023-02-09",
      "TransferReceiveDate": "2023-02-09"
    }
  ]
}