GET

List unspents on a wallet

Path Params

coin string required

A cryptocurrency symbol or token ticker symbol

at least 1 characters
walletId string required

at least 1 characters · matches ^[0-9a-f]{32}$

Query Params

limit string number

Limit the number of results.

>= 0 · <= 2000

Defaults to 25
prevId string

Only return results created after this ID

at least 1 characters
chains array of strings

Filter by chains. May be given mutiple times
minConfirms string number

The minimum number of confirmations for the unspents
enforceMinConfirmsForChange boolean

Whether to enforce the minimum number of confirmations for change outputs
minValue string

The minimum value of unspents to return (in base units, e.g. satoshis)

at least 1 characters
maxValue string

The maximum value of unspents to return (in base units, e.g. satoshis)

at least 1 characters
unspentIds array of strings

Canton: filter to specific IMS unspent contract ids (repeat param or comma-separated). Ignored for other chains that use this route.
token string

Canton: filter UTXOs by token name (e.g. "canton:usd1"). Omit to return native coin UTXOs only (default, backwards compatible). Ignored for other chains that use this route.

at least 1 characters

Responses

200

Response Body

object

unspents array of objects required
unspents object
- chain number
  
  The chain of the UTXO
- index number
  
  The index of the UTXO
- redeemScript string
  
  The redeem script of the UTXO
- witnessScript string
  
  The witness script of the UTXO
- id string
  
  The ID of the UTXO
- address string
  
  The address of the UTXO
- value number
  
  The value of the UTXO
- blockHeight number
  
  The block this Unspent was created in
- coinbase boolean
  
  True if this unspent came from the coinbase transaction
nextBatchPrevId string

The ID from where the results can continue
coin string

A cryptocurrency symbol or token ticker symbol
bumpFee string number

fee bump

400

Bad Request

Response Body

object

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

curl --request GET \ --url 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/unspents?limit=25&prevId=string&chains=&minConfirms=string&enforceMinConfirmsForChange=true&minValue=string&maxValue=string&unspentIds=&token=string' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const url = 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/unspents?limit=25&prevId=string&chains=&minConfirms=string&enforceMinConfirmsForChange=true&minValue=string&maxValue=string&unspentIds=&token=string'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}}; 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/unspents?limit=25&prevId=string&chains=&minConfirms=string&enforceMinConfirmsForChange=true&minValue=string&maxValue=string&unspentIds=&token=string") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/v2/coin/wallet/walletId/unspents?limit=25&prevId=string&chains=&minConfirms=string&enforceMinConfirmsForChange=true&minValue=string&maxValue=string&unspentIds=&token=string', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/coin/wallet/walletId/unspents?limit=25&prevId=string&chains=&minConfirms=string&enforceMinConfirmsForChange=true&minValue=string&maxValue=string&unspentIds=&token=string" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN" } response = requests.get(url, headers=headers) print(response.text)

{ "unspents": [ { "chain": 0, "index": 0, "redeemScript": "string", "witnessScript": "string", "id": "string", "address": "string", "value": 0, "blockHeight": 0, "coinbase": true } ], "nextBatchPrevId": "string", "coin": "btc", "bumpFee": "string" }