Blockchain.com · JSON Structure

Data Api Address Structure

Address summary including balances and transaction history.

Type: object Properties: 8
CryptocurrencyBitcoinBlockchain DataExchangeMarket DataTradingPaymentsPublic APIs

Address is a JSON Structure definition published by Blockchain.com, describing 8 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

hash160 address n_tx n_unredeemed total_received total_sent final_balance txs

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blockchain/refs/heads/main/json-structure/data-api-address-structure.json",
  "name": "Address",
  "description": "Address summary including balances and transaction history.",
  "type": "object",
  "properties": {
    "hash160": {
      "type": "string",
      "description": "Hash160 representation of the address.",
      "example": "00000000000000000004f4e7a18a09b1f8e96d6fb01d9b6fce4d12cb3f8a7e21"
    },
    "address": {
      "type": "string",
      "description": "Bitcoin address.",
      "example": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
    },
    "n_tx": {
      "type": "int32",
      "description": "Number of transactions involving this address.",
      "example": 1
    },
    "n_unredeemed": {
      "type": "int32",
      "description": "Number of unredeemed outputs.",
      "example": 1
    },
    "total_received": {
      "type": "int64",
      "description": "Total received in Satoshi.",
      "example": 1
    },
    "total_sent": {
      "type": "int64",
      "description": "Total sent in Satoshi.",
      "example": 1
    },
    "final_balance": {
      "type": "int64",
      "description": "Current balance in Satoshi.",
      "example": 100000
    },
    "txs": {
      "type": "array",
      "description": "Recent transactions involving the address (paginated).",
      "items": {
        "type": "object",
        "description": "A Bitcoin transaction with its inputs and outputs.",
        "properties": {
          "hash": {
            "type": "string",
            "description": "Transaction hash.",
            "example": "00000000000000000004f4e7a18a09b1f8e96d6fb01d9b6fce4d12cb3f8a7e21"
          },
          "ver": {
            "type": "int32",
            "description": "Transaction version.",
            "example": 1
          },
          "vin_sz": {
            "type": "int32",
            "description": "Number of inputs.",
            "example": 1
          },
          "vout_sz": {
            "type": "int32",
            "description": "Number of outputs.",
            "example": 1
          },
          "size": {
            "type": "int32",
            "description": "Serialized transaction size in bytes.",
            "example": 1
          },
          "weight": {
            "type": "int32",
            "description": "Transaction weight (BIP141).",
            "example": 1
          },
          "fee": {
            "type": "int64",
            "description": "Fee paid in Satoshi.",
            "example": 1
          },
          "relayed_by": {
            "type": "string",
            "description": "IP address that relayed the transaction."
          },
          "lock_time": {
            "type": "int64",
            "description": "Lock time (block height or Unix seconds).",
            "example": 1748609400000
          },
          "tx_index": {
            "type": "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": "int64",
            "description": "First-seen time (Unix seconds).",
            "example": 1748609400000
          },
          "block_index": {
            "type": "int64",
            "description": "Block index containing the transaction (null if unconfirmed).",
            "example": 1
          },
          "block_height": {
            "type": "int32",
            "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"
            }
          }
        }
      }
    }
  }
}