Create an allocation key

Endpoint Parameters

• Request parameters

  Name	Type	Origin	Description
  AllocationKeyName	String	Body	Name of the allocation key.
  AllocationUnitType	AllocationUnitType	Body	Specifies how to interpret the value of UnitValue in the AllocationKeyAccountInfo.
  MarginHandling	MarginHandlingType	Body	Represents the behavior if because of margin reason entire order can not be processed.
  OneTime	Boolean	Body	Whether the key is for one time use.
  OwnerAccountKey	AccountKey	Body	Account key for the account to this allocation key belongs to.
  ParticipatingAccountsInfo	AllocationKeyAccountInfo []	Body	Allocation participants.

• Response Parameters

  View Response Codes

  Name	Type	Description
  AllocationKeyId	String	Newly created allocation key ID.

  HTTP Code	Description
  201	Created	Allocation key added.
  400	Bad Request	Error Code Description DomainValidationError Domain Validation Failed! InvalidModelState One or more properties of the request are invalid! InvalidRequest The request is invalid!
  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

  POST /trade/v1/allocationkeys

  Request Body

  {
    "AllocationKeyName": "MyAllocation_Key",
    "AllocationUnitType": "Percentage",
    "MarginHandling": "Reduce",
    "OneTime": true,
    "OwnerAccountKey": "LZTc7DdejXODf-WSl2aCyQ==",
    "ParticipatingAccountsInfo": [
      {
        "AcceptRemainderAmount": true,
        "AccountKey": "LZTc7DdejXODf-WSl2aCyQ==",
        "Priority": 1,
        "UnitValue": 10
      },
      {
        "AcceptRemainderAmount": false,
        "AccountKey": "LZTc7DdejXODf-WSl2aCyQ==",
        "Priority": 1,
        "UnitValue": 90
      }
    ]
  }
  

• Response Example

  Response body

  {
    "AllocationKeyId": "227"
  }