Allocate funds to Partner Connection

post/api/network/v1/enterprises/{enterpriseId}/clients/connections/{connectionId}/allocations

This API call allows clients to allocate funds to a connected partner for trade. A successful allocation indicates that funds are locked at BitGo and available for spend on the connected partner. Note: Allocations will happen synchronously and allocated amounts can be viewed in the BitGo Application or via a balances endpoint.

Path Parameters

  • connectionIdstringRequired
  • enterpriseIdstringRequired
    Min length: >= 1 characters

Request Body

amount object required
currency string required
quantity string required
clientExternalId string required
Min length: >= 1 characters
nonce string required
Min length: >= 1 characters
notes string
Min length: >= 1 characters
payload string required
Min length: >= 1 characters
signature string required
Min length: >= 1 characters

200 Response

One of
allocation object required
id string required
amountOne ofrequired
connectionId string required
clientExternalId string required
Min length: >= 1 characters
partnerExternalId string
Min length: >= 1 characters
initiatedBy string required
Min length: >= 1 characters
notes string
Min length: >= 1 characters
createdAt string <date-time>required
updatedAt string <date-time>required
retriable boolean required
Allowed value: false
status string required
Allowed value: cleared

400 Response

401 Response

error string required

403 Response

error string required

404 Response

error string required

422 Response

allocation object required
id string required
amountOne ofrequired
connectionId string required
clientExternalId string required
Min length: >= 1 characters
partnerExternalId string
Min length: >= 1 characters
initiatedBy string required
Min length: >= 1 characters
notes string
Min length: >= 1 characters
createdAt string <date-time>required
updatedAt string <date-time>required
retriable boolean required
Allowed value: false
status string required
Allowed value: released
reason string required
Min length: >= 1 characters
error string required

500 Response

One of
error string required