Wallet

Balance Endpoint

Overview

The Balance Endpoint offers comprehensive balance and transaction data for specified wallet addresses. This endpoint is specifically tailored to provide detailed insights into the runes and bitcoin associated with a given address.

Functionality

• Address Parameter: Users must specify a wallet address to query its balance and transaction data.

• Real-Time Data on Runes: The endpoint focuses on providing detailed information about runes and bitcoin held in the queried wallet.

• UTXOs and UTXOsIds: Understanding the difference between utxos and utxosIds is crucial:

  • utxos: This array contains detailed information about each unspent transaction output (UTXO) that has been parsed and is available for the specified wallet address.

  • utxosIds: Represents all UTXOs associated with the wallet, including those not yet parsed. Initially, new wallet queries may show only utxosIds without corresponding utxos data, indicating that parsing is pending. Subsequent queries will reveal detailed UTXO data as parsing is completed.

Endpoint Details

Get wallet balance and UTXO data

GEThttps://api-dev.saturnbtc.io/v0/wallet/balance

Authorization

bearer

Query parameters

Response

200401500

Wallet - The wallet's balance runes, btc and UTXO data.

Body

application/json

address*string

cardinalBalance*string

balance*string

utxosIds*array of string

utxos*array of object

Request

JavaScriptCurlPython

const response = await fetch('https://api-dev.saturnbtc.io/v0/wallet/balance?address=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401500

{
  "address": "text",
  "cardinalBalance": "text",
  "balance": "text",
  "utxosIds": [
    "text"
  ],
  "utxos": [
    {
      "collectionStatuses": [
        {
          "amount": "text",
          "isWatchedByUser": false,
          "id": "text",
          "name": "text",
          "displayName": "text",
          "symbol": "text",
          "tradeable": false,
          "verified": false,
          "icon": "text",
          "priority": 0,
          "divisibility": 0,
          "supply": "text",
          "batchSize": "text",
          "transactionId": "text",
          "createdAt": "text"
        }
      ],
      "isUsed": false,
      "cardinalBalance": "text",
      "hasInscription": false,
      "inscription": {
        "name": "text",
        "id": "text",
        "address": "text",
        "outputValue": "text",
        "sat": 0,
        "preview": "text",
        "content": "text",
        "contentLength": 0,
        "contentType": "text",
        "timestamp": "text",
        "genesisHeight": 0,
        "genesisFee": 0,
        "genesisTxid": "text",
        "location": "text",
        "output": "text",
        "offset": 0
      },
      "txid": "text",
      "vout": 0,
      "status": {
        "confirmed": false,
        "block_height": 0,
        "block_hash": "text",
        "block_time": 0
      },
      "value": "text"
    }
  ]
}

• Parameters:

  • address (string, required): The wallet address for which balance and UTXO data is requested.

Response Structure

The response from this endpoint provides a JSON object with the following key details:

• address: The queried wallet address.

• balance: The overall balance of the wallet.

• utxos: An array of UTXO objects, each containing:

  • Details about its balance and associated collections.

  • Information on any inscriptions, including their content and metadata.

• utxosIds: An array of UTXO IDs representing all UTXOs associated with the wallet.

• Each UTXO and collection item contains additional fields such as market price, batch size, verification status, and timestamps.