bsv_explore

Explore Bitcoin SV blockchain data using the configured explorer API. Access multiple data types: CHAIN DATA: - chain_info: Network stats, difficulty, and chain work - chain_tips: Current chain tips including heights and states - circulating_supply: Current BSV circulating supply - peer_info: Connected peer statistics BLOCK DATA: - block_by_hash: Complete block data via hash (requires blockHash parameter) - block_by_height: Complete block data via height (requires blockHeight parameter) - tag_count_by_height: Stats on tag count for a specific block via height (requires blockHeight parameter) - block_headers: Retrieves the last 10 block headers - block_pages: Retrieves pages of transaction IDs for large blocks (requires blockHash and optional pageNumber) STATS DATA: - block_stats_by_height: Block statistics for a specific height (requires blockHeight parameter) - block_miner_stats: Block mining statistics for a time period (optional days parameter, default 7) - miner_summary_stats: Summary of mining statistics (optional days parameter, default 7) TRANSACTION DATA: - tx_by_hash: Detailed transaction data (requires txHash parameter) - tx_raw: Raw transaction hex data (requires txHash parameter) - tx_receipt: Transaction receipt (requires txHash parameter) - bulk_tx_details: Bulk transaction details (requires txids parameter as array of transaction hashes) ADDRESS DATA: - address_history: Transaction history for address (requires address parameter, optional limit) - address_utxos: Unspent outputs for address (requires address parameter) NETWORK: - health: API health check Use the appropriate parameters for each endpoint type and specify 'main' or 'test' network.

Read as Markdown

Result

Explorer data for the selected address, block or transaction query.

Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

Also available through bsv_read in compact mode.

Inputs and availability

Full catalog · Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Project · payments scope; External BRC-100 wallet; Local Vault + sponsor; Droplit wallet

Field	Type / required	Description
endpoint	"chain_info" \| "chain_tips" \| "circulating_supply" \| "peer_info" \| "block_by_hash" \| "block_by_height" \| "block_headers" \| "block_pages" \| "tag_count_by_height" \| "block_stats_by_height" \| "block_miner_stats" \| "miner_summary_stats" \| "tx_by_hash" \| "tx_raw" \| "tx_receipt" \| "bulk_tx_details" \| "address_history" \| "address_utxos" \| "health" Required	configured explorer API endpoint to call
network	"main" \| "test" Optional	Network to use (main or test) default: "main"
blockHash	string Optional	Block hash (required for block_by_hash endpoint)
blockHeight	number Optional	Block height (required for block_by_height and block_stats_by_height endpoints)
txHash	string Optional	Transaction hash (required for tx_by_hash, tx_raw, and tx_receipt endpoints)
txids	array of string Optional	Array of transaction IDs for bulk_tx_details endpoint
address	string Optional	Bitcoin address (required for address_history and address_utxos endpoints)
limit	number Optional	Limit for paginated results (optional for address_history)
pageNumber	number Optional	Page number for block_pages endpoint (defaults to 1)
days	number Optional	Number of days for miner stats endpoints (defaults to 7)

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "enum": [
        "chain_info",
        "chain_tips",
        "circulating_supply",
        "peer_info",
        "block_by_hash",
        "block_by_height",
        "block_headers",
        "block_pages",
        "tag_count_by_height",
        "block_stats_by_height",
        "block_miner_stats",
        "miner_summary_stats",
        "tx_by_hash",
        "tx_raw",
        "tx_receipt",
        "bulk_tx_details",
        "address_history",
        "address_utxos",
        "health"
      ],
      "description": "configured explorer API endpoint to call"
    },
    "network": {
      "default": "main",
      "description": "Network to use (main or test)",
      "type": "string",
      "enum": [
        "main",
        "test"
      ]
    },
    "blockHash": {
      "description": "Block hash (required for block_by_hash endpoint)",
      "type": "string"
    },
    "blockHeight": {
      "description": "Block height (required for block_by_height and block_stats_by_height endpoints)",
      "type": "number"
    },
    "txHash": {
      "description": "Transaction hash (required for tx_by_hash, tx_raw, and tx_receipt endpoints)",
      "type": "string"
    },
    "txids": {
      "description": "Array of transaction IDs for bulk_tx_details endpoint",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "description": "Bitcoin address (required for address_history and address_utxos endpoints)",
      "type": "string"
    },
    "limit": {
      "description": "Limit for paginated results (optional for address_history)",
      "type": "number"
    },
    "pageNumber": {
      "description": "Page number for block_pages endpoint (defaults to 1)",
      "type": "number"
    },
    "days": {
      "description": "Number of days for miner stats endpoints (defaults to 7)",
      "type": "number"
    }
  },
  "required": [
    "endpoint"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}