POST

Consolidate account (advanced)

Build a consolidation transaction for an account-based asset. Once built, you must sign and send the transaction. For account-based assets, consolidating the balances in the receive addresses to the base address maximizes the spendable balance of a wallet.

Path Params

coin string enum required

This route is only available for Algorand, Tezos, and Eth.

algotalgoxtztxtzethhteth
walletId string required

The wallet ID.

matches ^[0-9a-f]{32}$

Body Params

object

consolidateAddresses array of strings

Optional: restrict the consolidation to the specified receive addresses. If not provided, will consolidate the funds from all receive addresses up to 500 addresses.
apiVersion string enum

The Trasaction Request API version to use for MPC EdDSA Hot Wallets. Defaults based on the wallet type and asset curve.

fulllite

Responses

200

Response Body

object

keyDerivationPath string

400

Bad Request

Response Body

ONE OF

error string required

Human-readable error message
requestId string required

Client request id
context object

Properties that apply to a specific error name
name string required

Error code

error string required

Human-readable error message
requestId string required

Client request id
context object required
context object
- address string required
- coin string required
  
  A cryptocurrency or token ticker symbol.
name string enum required

Error code

InvalidAddress

error string required

Human-readable error message
requestId string required

Client request id
context object required
context object
- id string
  
  matches ^[0-9a-f]{32}$
name string enum required

Error code

InvalidWalletId

curl --request POST \ --url 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/consolidateAccount/build' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"consolidateAddresses":["string"],"apiVersion":"full"}'

const url = 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/consolidateAccount/build'; const options = { method: 'POST', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'content-type': 'application/json'}, body: JSON.stringify({,"consolidateAddresses":["string"],"apiVersion":"full"}) }; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/coin/wallet/walletId/consolidateAccount/build") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"consolidateAddresses":["string"],"apiVersion":"full"}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/consolidateAccount/build', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"consolidateAddresses":["string"],"apiVersion":"full"}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/coin/wallet/walletId/consolidateAccount/build" payload = {,"consolidateAddresses":["string"],"apiVersion":"full"} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)