View UTXO
List unspent transaction outputs for a UTXO-based wallet. See the Guide.
-
You view the unspent transaction outputs (UTXOs) for any wallet containing UTXO-based coins. This is helpful because every outgoing transaction includes a certain amount of UTXO to cover blockchain fees. The UTXO locked to transactions pending approval impacts the available UTXO in your wallet.
Prerequisites: You must have completed Get Started and Create Wallets.
// 1. List Unspents
export COIN="tbtc4"
export WALLET_ID="<YOUR_WALLET_ID>"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
curl -X GET \
https://app.bitgo-test.com/api/v2/$COIN/wallet/$WALLET_ID/unspents \
-H "Authorization: Bearer $ACCESS_TOKEN"
// 1. List Unspents
import * as dotenv from "dotenv";
import {EnvironmentName} from "bitgo";
import {BitGoAPI} from "@bitgo/sdk-api";
import {Tbtc4} from "@bitgo/sdk-coin-btc";
dotenv.config();
const bitgo = new BitGoAPI({
env: process.env.ENV as EnvironmentName,
accessToken: process.env.TESTNET_ACCESS_TOKEN
});
const coin = 'tbtc4';
bitgo.register(coin, Tbtc4.createInstance);
const walletId = process.env.WALLET_ID;
async function main() {
const walletInstance = await bitgo.coin(coin).wallets().get({id: walletId});
walletInstance.unspents().then(function (unspents) {
// print unspents
console.dir(unspents);
});
}
main().catch((err) => console.error(err));
Response
// 1. List Unspents Response
{
"coin": "tbtc4",
"unspents": [
{
"id": "a4b7c2d1e3f5908172a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f80:0",
"address": "tb1qgrgcsu2dkvfcte8q52za3htkmwgmj8qh6ktq973zsz3qhlg0ny8q8ajtdd",
"value": 100000,
"valueString": "100000",
"blockHeight": 141632,
"date": "2026-06-25T16:16:09.000Z",
"wallet": "5e8d3f1a2b7c4e9d0f1a2b3c",
"fromWallet": "5d1a4b7c9e2f3a8d0b5c6e7f",
"chain": 20,
"index": 0,
"witnessScript": "5221034ab17c91d582b9c3e285fccb8b8c6e31e1a9d7f2b543c0e1d6a7f8b9c2d4e5f2102a1b2c3d4e5f607182930a1b2c3d4e5f607182930a1b2c3d4e5f607182930a121039b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f0a9b853ae",
"isSegwit": true
}
],
"resultMessage": "success"
}