Blockchain.com · Schema

MultiAddressResponse

Multi-address summary plus recent transactions across all addresses.

CryptocurrencyBitcoinBlockchain DataExchangeMarket DataTradingPaymentsPublic APIs

Properties

Name Type Description
addresses array Per-address summary entries.
wallet object Aggregate balances across the supplied addresses.
txs array Most recent transactions across all addresses.
View JSON Schema on GitHub

JSON Schema

data-api-multi-address-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blockchain/refs/heads/main/json-schema/data-api-multi-address-response-schema.json",
  "title": "MultiAddressResponse",
  "description": "Multi-address summary plus recent transactions across all addresses.",
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "description": "Per-address summary entries.",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string"
          },
          "n_tx": {
            "type": "integer"
          },
          "total_received": {
            "type": "integer",
            "format": "int64"
          },
          "total_sent": {
            "type": "integer",
            "format": "int64"
          },
          "final_balance": {
            "type": "integer",
            "format": "int64"
          },
          "change_index": {
            "type": "integer"
          },
          "account_index": {
            "type": "integer"
          }
        }
      }
    },
    "wallet": {
      "type": "object",
      "description": "Aggregate balances across the supplied addresses.",
      "properties": {
        "n_tx": {
          "type": "integer"
        },
        "n_tx_filtered": {
          "type": "integer"
        },
        "total_received": {
          "type": "integer",
          "format": "int64"
        },
        "total_sent": {
          "type": "integer",
          "format": "int64"
        },
        "final_balance": {
          "type": "integer",
          "format": "int64"
        }
      }
    },
    "txs": {
      "type": "array",
      "description": "Most recent transactions across all addresses.",
      "items": {
        "type": "object",
        "description": "A Bitcoin transaction with its inputs and outputs.",
        "properties": {
          "hash": {
            "type": "string",
            "description": "Transaction hash.",
            "example": "00000000000000000004f4e7a18a09b1f8e96d6fb01d9b6fce4d12cb3f8a7e21"
          },
          "ver": {
            "type": "integer",
            "description": "Transaction version.",
            "example": 1
          },
          "vin_sz": {
            "type": "integer",
            "description": "Number of inputs.",
            "example": 1
          },
          "vout_sz": {
            "type": "integer",
            "description": "Number of outputs.",
            "example": 1
          },
          "size": {
            "type": "integer",
            "description": "Serialized transaction size in bytes.",
            "example": 1
          },
          "weight": {
            "type": "integer",
            "description": "Transaction weight (BIP141).",
            "example": 1
          },
          "fee": {
            "type": "integer",
            "format": "int64",
            "description": "Fee paid in Satoshi.",
            "example": 1
          },
          "relayed_by": {
            "type": "string",
            "description": "IP address that relayed the transaction."
          },
          "lock_time": {
            "type": "integer",
            "format": "int64",
            "description": "Lock time (block height or Unix seconds).",
            "example": 1748609400000
          },
          "tx_index": {
            "type": "integer",
            "format": "int64",
            "description": "Internal transaction index.",
            "example": 1
          },
          "double_spend": {
            "type": "boolean",
            "description": "True if the transaction is a known double-spend.",
            "example": true
          },
          "time": {
            "type": "integer",
            "format": "int64",
            "description": "First-seen time (Unix seconds).",
            "example": 1748609400000
          },
          "block_index": {
            "type": "integer",
            "format": "int64",
            "description": "Block index containing the transaction (null if unconfirmed).",
            "example": 1
          },
          "block_height": {
            "type": "integer",
            "description": "Block height containing the transaction (null if unconfirmed).",
            "example": 851234
          },
          "inputs": {
            "type": "array",
            "description": "Transaction inputs.",
            "items": {
              "$ref": "#/components/schemas/TxInput"
            }
          },
          "out": {
            "type": "array",
            "description": "Transaction outputs.",
            "items": {
              "$ref": "#/components/schemas/TxOutput"
            }
          }
        }
      }
    }
  }
}