v1

latestOpenAPI 3.0.02026-08-04134348905.1 KB

Subaccounts

Create new allocations

Permissions required: Subaccount

Create new allocation of pre-funded values between the Funding and Program Customers' subaccounts. This is a transactional operation, all transactions will be created successfully or none will.

post/subaccounts/transactions/allocations

Headers

Api-Signaturestring required

A hex-encoded Ed25519 signature of timestamp_epoch_seconds + uppercase(http_method) + request_path + request_body.

Construction example:

toHex(
  ed25519Sign(
    signing_key,
    '{}{}{}{}'.format(timestamp_epoch_seconds, toUpper(httpMethod), httpRequestPath, httpBody)
  )
)

Api-Timestampinteger required

Current timestamp, represented as unix epoch seconds

Request body

idempotentIdstring required

A client-provided unique ID for idempotent requests

Example request

{
  "allocations": [
    {
      "amount": "1000.00",
      "assetType": "USD",
      "subaccountId": "ec761b5e-fd2c-497a-a9a0-f8738ac97bdf"
    }
  ],
  "idempotentId": "12838927347"
}

Response

Successfully created the transactions

idempotentIdstring required

A client-provided unique ID for idempotent requests

transactionIdsstring[]

Example response

{
  "idempotentId": "12838927347"
}