BlockBook (legacy v1)

Get BlockBook and backend status

get

Returns general information about the BlockBook instance and the connected Bcash backend node.

Authorizations

api-keystringRequired

Responses

200

Successful response with BlockBook and backend status

application/json

get

/api/v1

GET /api/v1 HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response with BlockBook and backend status

{
  "blockbook": {
    "coin": "Bcash",
    "host": "5eccb858ad56",
    "version": "devel",
    "gitCommit": "1322a919",
    "buildTime": "2023-06-08T12:23:48+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 4197420,
    "lastBlockTime": "2026-01-16T12:27:22.115775026Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-01-16T12:27:31.355293003Z",
    "mempoolSize": 4,
    "decimals": 8,
    "dbSize": 69251869499,
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "main",
    "blocks": 4197420,
    "headers": 4197420,
    "bestBlockHash": "00000000000078a22c6a07170a46f158961e51fcd3a6b4946659b1bb65142aab",
    "difficulty": "77174.25716955366",
    "sizeOnDisk": 44237589224,
    "version": "4060100",
    "subversion": "/Bcash:4.6.1(Bcash.network)/",
    "protocolVersion": "70028"
  }
}

Get block hash by block height

get

Returns the block hash corresponding to the specified block height in the Bcash blockchain.

Authorizations

api-keystringRequired

Path parameters

heightintegerRequired

Block height for which the block hash is requested

Example: 4197420

Responses

200

Successful response containing the block hash

application/json

blockHashstringOptional

Hash of the block at the specified height

Example: 000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512

get

/api/v1/block-index/{height}

GET /api/v1/block-index/{height} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response containing the block hash

{
  "blockHash": "000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512"
}

Get block details by block height

get

Returns detailed block information using the legacy BlockBook v1 format. Values are represented in BCH units instead of satoshis.

Authorizations

api-keystringRequired

Path parameters

heightintegerRequired

Block height (integer) or block hash (string) to identify the block.

Example: 4197220

Responses

200

Successful response containing block details in v1 format

application/json

pageintegerOptional

Current page number

Example: 1

totalPagesintegerOptional

Total number of available pages

Example: 1

itemsOnPageintegerOptional

Number of transactions per page

Example: 1000

hashstringOptional

Block hash

Example: 000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512

previousBlockHashstringOptional

Hash of the previous block

Example: 000000000000894844979ad0b8fdbd36d0eaf99a8488b01cf13bc2ab6abc3ce0

nextBlockHashstringOptional

Hash of the next block

Example: 00000000000077002d85c7c2a568a494c7c95c5c73d1a6a357440b5a57fabccf

heightintegerOptional

Block height

Example: 4197220

confirmationsintegerOptional

Number of confirmations

Example: 201

sizeintegerOptional

Block size in bytes

Example: 505

timeintegerOptional

Unix timestamp when the block was mined

Example: 1768553331

versionintegerOptional

Block version

Example: 805306368

merkleRootstringOptional

Merkle root of the block

Example: 164cca0cd09959450fc9cc44113bb175c302326b69d9119bb394e27776151836

noncestringOptional

Nonce used to mine the block

Example: 0

bitsstringOptional

Difficulty target bits

Example: 1b00c624

difficultystringOptional

Mining difficulty

Example: 84671.98485923823

txCountintegerOptional

Number of transactions in the block

Example: 2

get

/api/v1/block/{blockHeightOrHash}

GET /api/v1/block/{blockHeightOrHash} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response containing block details in v1 format

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512",
  "previousBlockHash": "000000000000894844979ad0b8fdbd36d0eaf99a8488b01cf13bc2ab6abc3ce0",
  "nextBlockHash": "00000000000077002d85c7c2a568a494c7c95c5c73d1a6a357440b5a57fabccf",
  "height": 4197220,
  "confirmations": 201,
  "size": 505,
  "time": 1768553331,
  "version": 805306368,
  "merkleRoot": "164cca0cd09959450fc9cc44113bb175c302326b69d9119bb394e27776151836",
  "nonce": "0",
  "bits": "1b00c624",
  "difficulty": "84671.98485923823",
  "txCount": 2,
  "txs": [
    {
      "txid": "eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2",
      "vin": [
        {
          "txid": "",
          "vout": 0,
          "n": 0,
          "scriptSig": {},
          "addresses": [],
          "value": "0"
        }
      ],
      "vout": [
        {
          "value": "2500.0058806",
          "n": 0,
          "scriptPubKey": {
            "addresses": [
              "REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7"
            ]
          },
          "spent": true
        }
      ],
      "blockhash": "000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512",
      "blockheight": 4197220,
      "confirmations": 201,
      "time": 1768553331,
      "blocktime": 1768553331,
      "valueOut": "2500.0058806",
      "valueIn": "0",
      "fees": "0",
      "hex": ""
    }
  ]
}

Get detailed transaction information

get

Returns detailed transaction information using the legacy BlockBook v1 tx-specific format. Includes raw transaction hex, inputs, outputs, and block metadata.

Authorizations

api-keystringRequired

Path parameters

txidstringRequired

Transaction identifier (TXID)

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2

Responses

200

Successful response containing transaction details

application/json

txidstringOptional

Transaction identifier

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2

hashstringOptional

Transaction hash (internal representation)

Example: cafeaab897f566d7f5153b67213e8b0c53571519ef1e5a6741e9d939edf7020f

versionintegerOptional

Transaction version

Example: 1

sizeintegerOptional

Transaction size in bytes

Example: 192

vsizeintegerOptional

Virtual transaction size

Example: 165

locktimeintegerOptional

Transaction locktime

Example: 0

hexstringOptional

Raw transaction hex

Example:

010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff1803640b4040022f42696e616e63652f31207f05475a166306ffffffff021c3d32353a0000001976a914383728f848001d3faa649269a3f940890b4a0da188ac0000000000000000266a24aa21a9ed995fb49ed60c575ac789a4392155e51594c4104d4226aa26249f42cc334c1efa0120000000000000000000000000000000000000000000000000000000000000000000000000

blockhashstringOptional

Hash of the block containing the transaction

Example: 000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512

heightintegerOptional

Block height containing the transaction

Example: 4197220

confirmationsintegerOptional

Number of confirmations

Example: 201

timeintegerOptional

Transaction timestamp (Unix time)

Example: 1768553331

blocktimeintegerOptional

Block timestamp (Unix time)

Example: 1768553331

get

/api/v1/tx-specific/{txid}

GET /api/v1/tx-specific/{txid} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response containing transaction details

{
  "txid": "eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2",
  "hash": "cafeaab897f566d7f5153b67213e8b0c53571519ef1e5a6741e9d939edf7020f",
  "version": 1,
  "size": 192,
  "vsize": 165,
  "locktime": 0,
  "vin": [
    {
      "coinbase": "03640b4040022f42696e616e63652f31207f05475a166306",
      "sequence": 4294967295
    }
  ],
  "vout": [
    {
      "value": 2500.0059,
      "n": 0,
      "scriptPubKey": {
        "asm": "OP_DUP OP_HASH160 383728f848001d3faa649269a3f940890b4a0da1 OP_EQUALVERIFY OP_CHECKSIG",
        "hex": "76a914383728f848001d3faa649269a3f940890b4a0da188ac",
        "reqSigs": 1,
        "type": "pubkeyhash",
        "addresses": [
          "REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7"
        ]
      },
      "spentTxId": "9f19baca7d15e7d2152830e802d67d384303b08adeab1838edebbd815ddf9f88",
      "spentIndex": 39,
      "spentHeight": 4197409,
      "valueSat": 250000588060
    }
  ],
  "hex": "010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff1803640b4040022f42696e616e63652f31207f05475a166306ffffffff021c3d32353a0000001976a914383728f848001d3faa649269a3f940890b4a0da188ac0000000000000000266a24aa21a9ed995fb49ed60c575ac789a4392155e51594c4104d4226aa26249f42cc334c1efa0120000000000000000000000000000000000000000000000000000000000000000000000000",
  "blockhash": "000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512",
  "height": 4197220,
  "confirmations": 201,
  "time": 1768553331,
  "blocktime": 1768553331
}

Get transaction details by transaction ID

get

Returns a transaction in BlockBook v1 legacy format. This is the older format, for backward compatibility.

Authorizations

api-keystringRequired

Path parameters

txidstringRequired

Transaction identifier (TXID)

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2

Responses

200

Successful response containing transaction data

application/json

txidstringOptional

Transaction identifier

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2

versionintegerOptional

Transaction version

Example: 1

blockhashstringOptional

Hash of the block containing the transaction

Example: 000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512

blockheightintegerOptional

Block height containing the transaction

Example: 4197220

confirmationsintegerOptional

Number of confirmations

Example: 201

timeintegerOptional

Transaction time (Unix timestamp)

Example: 1768553331

blocktimeintegerOptional

Block timestamp (Unix timestamp)

Example: 1768553331

valueOutstringOptional

Total output value

Example: 2500.0058806

sizeintegerOptional

Transaction size in bytes

Example: 192

valueInstringOptional

Total input value

Example: 0

feesstringOptional

Transaction fee

Example: 0

hexstringOptional

Raw transaction hex

Example:

010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff1803640b4040022f42696e616e63652f31207f05475a166306ffffffff021c3d32353a0000001976a914383728f848001d3faa649269a3f940890b4a0da188ac0000000000000000266a24aa21a9ed995fb49ed60c575ac789a4392155e51594c4104d4226aa26249f42cc334c1efa0120000000000000000000000000000000000000000000000000000000000000000000000000

get

/api/v1/tx/{txid}

GET /api/v1/tx/{txid} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response containing transaction data

{
  "txid": "eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2",
  "version": 1,
  "vin": [
    {
      "txid": "",
      "vout": 0,
      "sequence": 4294967295,
      "n": 0,
      "scriptSig": {},
      "addresses": null,
      "value": ""
    }
  ],
  "vout": [
    {
      "value": "2500.0058806",
      "n": 0,
      "scriptPubKey": {
        "hex": "76a914383728f848001d3faa649269a3f940890b4a0da188ac",
        "addresses": [
          "REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7"
        ]
      },
      "spent": true
    }
  ],
  "blockhash": "000000000000a46e66b6ba67256ece7d162bc70cbdca0cbb8526905eea329512",
  "blockheight": 4197220,
  "confirmations": 201,
  "time": 1768553331,
  "blocktime": 1768553331,
  "valueOut": "2500.0058806",
  "size": 192,
  "valueIn": "0",
  "fees": "0",
  "hex": "010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff1803640b4040022f42696e616e63652f31207f05475a166306ffffffff021c3d32353a0000001976a914383728f848001d3faa649269a3f940890b4a0da188ac0000000000000000266a24aa21a9ed995fb49ed60c575ac789a4392155e51594c4104d4226aa26249f42cc334c1efa0120000000000000000000000000000000000000000000000000000000000000000000000000"
}

Get address details

get

Returns information about a specific address, including balances, transaction count, and transaction IDs.

Authorizations

api-keystringRequired

Path parameters

addressstringRequired

The blockchain address to query

Example: REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7

Responses

200

Successful response with address information

application/json

pageintegerOptional

Current page number

Example: 1

totalPagesintegerOptional

Total number of pages for transaction history

Example: 24

itemsOnPageintegerOptional

Number of items on the current page

Example: 1000

addrStrstringOptional

The queried address

Example: REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7

balancestringOptional

Confirmed balance (in coins)

Example: 12500.36366481

totalReceivedstringOptional

Total received by the address (in coins)

Example: 41767642.94689021

totalSentstringOptional

Total sent by the address (in coins)

Example: 41755142.5832254

unconfirmedBalancestringOptional

Unconfirmed balance (in coins)

Example: 0

unconfirmedTxApperancesintegerOptional

Number of unconfirmed transactions

Example: 0

txApperancesintegerOptional

Total number of transactions

Example: 23170

transactionsstring[]Optional

List of transaction IDs involving this address

Example:

["9f19baca7d15e7d2152830e802d67d384303b08adeab1838edebbd815ddf9f88","646935fb916b3298797db127a6019a440c3395054b910e227fc18e24941cd0de","b3a3a0029be86e20115767db4b431a80b3f24636bba48d742c62c57472af2cd7","275f34aab59867c3d7e82f012893e0afc27a77cff203130dbf3820f6fb9ef41c"]

get

/api/v1/address/{address}

GET /api/v1/address/{address} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response with address information

{
  "page": 1,
  "totalPages": 24,
  "itemsOnPage": 1000,
  "addrStr": "REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7",
  "balance": "12500.36366481",
  "totalReceived": "41767642.94689021",
  "totalSent": "41755142.5832254",
  "unconfirmedBalance": "0",
  "unconfirmedTxApperances": 0,
  "txApperances": 23170,
  "transactions": [
    "9f19baca7d15e7d2152830e802d67d384303b08adeab1838edebbd815ddf9f88",
    "646935fb916b3298797db127a6019a440c3395054b910e227fc18e24941cd0de",
    "b3a3a0029be86e20115767db4b431a80b3f24636bba48d742c62c57472af2cd7",
    "275f34aab59867c3d7e82f012893e0afc27a77cff203130dbf3820f6fb9ef41c"
  ]
}

Get UTXOs for an address

get

Returns a list of unspent transaction outputs (UTXOs) for the given address, XPUB, or descriptor.

Authorizations

api-keystringRequired

Path parameters

addressstringRequired

Address, XPUB or descriptor to query UTXOs for.

Example: REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7

Query parameters

confirmedbooleanOptional

If true, only return confirmed UTXOs. Defaults to false (returns both confirmed and unconfirmed).

Default: false

Responses

200

Successful response with UTXOs

application/json

List of UTXOs for the given address

txidstringOptional

Transaction ID of the UTXO

Example: 646935fb916b3298797db127a6019a440c3395054b910e227fc18e24941cd0de

voutintegerOptional

Index of the output in the transaction

Example: 0

amountstringOptional

Value of the UTXO in coins

Example: 2500.12506692

satoshisintegerOptional

Value of the UTXO in satoshis

Example: 250012506692

heightintegerOptional

Block height where the transaction was included

Example: 4197402

confirmationsintegerOptional

Number of confirmations for this UTXO

Example: 19

get

/api/v1/utxo/{addressOrXpubOrDescriptor}

GET /api/v1/utxo/{addressOrXpubOrDescriptor} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful response with UTXOs

[
  {
    "txid": "646935fb916b3298797db127a6019a440c3395054b910e227fc18e24941cd0de",
    "vout": 0,
    "amount": "2500.12506692",
    "satoshis": 250012506692,
    "height": 4197402,
    "confirmations": 19
  }
]

Estimate transaction fee per kilobyte

get

Estimates the fee (in coins) per kilobyte needed for a transaction to be confirmed within a certain number of blocks.

Authorizations

api-keystringRequired

Path parameters

blocksintegerRequired

Number of blocks within which the transaction should be confirmed

Example: 10

Responses

200

Successful fee estimation

application/json

resultstringOptional

Estimated fee per kilobyte in coins

Example: 0.01013364

get

/api/v1/estimatefee/{blocks}

GET /api/v1/estimatefee/{blocks} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Successful fee estimation

{
  "result": "0.01013364"
}

Broadcast raw transaction

get

Broadcasts a raw transaction in hexadecimal format to the network. Returns the transaction ID if successfully broadcast. Kindly note that if sendtx is too long, the hexadecimal transaction may be cut off. In this case, it is preferable to use the POST version of the sendtx method.

Authorizations

api-keystringRequired

Path parameters

hexTxDatastringRequired

Raw transaction data in hexadecimal string format.

Example: 0200000001abcdef...00000000

Responses

200

Transaction broadcast successfully

application/json

resultstringOptional

Transaction ID of the broadcast transaction

Example: 4a556c81e88d30f99f56a0df1d28de0f22d3d6a1342bc0bbe882a5201fe2b9ff

get

/api/v1/sendtx/{hexTxData}

GET /api/v1/sendtx/{hexTxData} HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

200

Transaction broadcast successfully

{
  "result": "4a556c81e88d30f99f56a0df1d28de0f22d3d6a1342bc0bbe882a5201fe2b9ff"
}

Broadcast raw transaction via POST body

post

Broadcasts a raw transaction provided in hexadecimal format via the request body. Returns the transaction ID if successfully broadcast.

Authorizations

api-keystringRequired

Body

hexstringOptional

Raw transaction in hexadecimal format

Example: 0200000001abcdef...00000000

Responses

200

Transaction broadcast successfully

application/json

resultstringOptional

Transaction ID of the broadcast transaction

Example: 4a556c81e88d30f99f56a0df1d28de0f22d3d6a1342bc0bbe882a5201fe2b9ff

post

/api/v1/sendtx/

POST /api/v1/sendtx/ HTTP/1.1
Host: bchbook.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "hex": "0200000001abcdef...00000000"
}

200

Transaction broadcast successfully

{
  "result": "4a556c81e88d30f99f56a0df1d28de0f22d3d6a1342bc0bbe882a5201fe2b9ff"
}

PreviousBlockBook NextBlockBook (legacy unversioned)

Last updated 23 days ago

hashtagGet BlockBook and backend status

hashtagGet block hash by block height

hashtagGet block details by block height

hashtagGet detailed transaction information

hashtagGet transaction details by transaction ID

hashtagGet address details

hashtagGet UTXOs for an address

hashtagEstimate transaction fee per kilobyte

hashtagBroadcast raw transaction

hashtagBroadcast raw transaction via POST body

Get BlockBook and backend status

Get block hash by block height

Get block details by block height

Get detailed transaction information

Get transaction details by transaction ID

Get address details

Get UTXOs for an address

Estimate transaction fee per kilobyte

Broadcast raw transaction

Broadcast raw transaction via POST body