Deallocate Assets
Overview
Deallocate assets from a connected partner to your Go Network account. Deallocating assets unlocks them at BitGo, making them available for any other action, such as rebalancing or withdrawing. Deallocations occur synchronously. You can view your deallocated balance from the BitGo web application or programmatically.
Prerequisites
1. Get Deallocation Payload
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
export ENTERPRISE_ID="<YOUR_ENTERPRISE_ID>" export CONNECTION_ID="<YOUR_CONNECTION_ID>" export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>" curl -X POST \ https://app.bitgo-test.com/api/network/v1/enterprises/$ENTERPRISE_ID/clients/connections/$CONNECTION_ID/deallocations/signing \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -d '{ "amount": { "currency": "string", "quantity": "string" }, "clientExternalId": "string", "nonce": "string", "notes": "string" }'
Step Result
1 2 3
{ "payload": "string" }
2. Create Deallocation Request
Endpoint: Deallocate Funds to Partner Connection
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
export ENTERPRISE_ID="<YOUR_ENTERPRISE_ID>" export CONNECTION_ID="<YOUR_CONNECTION_ID>" export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>" curl -X POST \ https://app.bitgo-test.com/api/network/v1/enterprises/$ENTERPRISE_ID/clients/connections/$CONNECTION_ID/deallocations \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -d '{ "amount": { "currency": "string", "quantity": "string" }, "clientExternalId": "string", "payload": "string", # The payload string received in the previous step "signature": "string", "nonce": "string", "notes": "string" }'
Step Result
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
{ "deallocation": { "status": "cleared", "id": "string", "amount": { "currency": "string", "quantity": "string" }, "connectionId": "string", "clientExternalId": "string", "partnerExternalId": "string", "initiatedBy": "string", "notes": "string", "createdAt": "2019-08-24", "updatedAt": "2019-08-24" } }