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

Endpoint: Get Signing Payload for Client Deallocations

  • cURL
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

  • JSON
1 2 3 { "payload": "string" }

2. Create Deallocation Request

Endpoint: Deallocate Funds to Partner Connection

  • cURL
  • JavaScript
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

  • JSON
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" } }

Next

View Go Network Details

See Also

API Reference: Deallocate Funds from Connection