BlockBook

Get BlockBook and backend status

get

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

Authorizations
api-keystringRequired
Responses
get
/api/v2
200

Successful response with BlockBook and backend status

Get block hash by block height

get

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

Authorizations
api-keystringRequired
Path parameters
heightintegerRequired

Block height for which the block hash is requested

Example: 4197420
Responses
get
/api/v2/block-index/{height}
200

Successful response containing the block hash

Get block details by block height

get

Returns detailed information about a block at the specified height or hash, including block metadata and a list of transactions.

Authorizations
api-keystringRequired
Path parameters
heightintegerRequired

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

Example: 4197220
Responses
get
/api/v2/block/{blockHeightOrHash}
200

Successful response containing block details

Get detailed transaction information

get

Returns a detailed transaction object including raw hex data, inputs, outputs, and block-related metadata.

Authorizations
api-keystringRequired
Path parameters
txidstringRequired

Transaction identifier (TXID)

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2
Responses
get
/api/v2/tx-specific/{txid}
200

Successful response containing transaction details

Get transaction details by transaction ID

get

Returns a simplified transaction representation in BlockBook v2 format. Values are represented in satoshis as strings.

Authorizations
api-keystringRequired
Path parameters
txidstringRequired

Transaction identifier (TXID)

Example: eddb27dea179495f955db5433a56f0e9790c8bb9ea209ab36952184789bfdea2
Responses
get
/api/v2/tx/{txid}
200

Successful response containing transaction data

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
get
/api/v2/address/{address}
200

Successful response with address information

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
get
/api/v2/utxo/{addressOrXpubOrDescriptor}
200

Successful response with UTXOs

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
get
/api/v2/estimatefee/{blocks}
200

Successful fee estimation

Get balance history for an address

get

Returns the balance history of a given address, including amounts received, sent, and sent to self, grouped by time intervals.

Authorizations
api-keystringRequired
Path parameters
addressstringRequired

The ECash address to retrieve balance history for

Example: REQRzqybtFvVGDGKpmGb8MaEGwuDczC1K7
Responses
get
/api/v2/balancehistory/{address}
200

Balance history data

Get list of tickers at a specific timestamp

get

Returns a list of cryptocurrency tickers and their rates at the specified timestamp.

Authorizations
api-keystringRequired
Query parameters
timestampintegerRequired

Unix timestamp to retrieve ticker data for

Example: 1768553331
Responses
get
/api/v2/tickers-list
200

List of tickers

Get XPUB/Descriptor Details

get

Returns balances and transaction history for the given extended public key (XPUB) or output descriptor.

Authorizations
api-keystringRequired
Path parameters
xpubOrDescriptorstringRequired

Extended public key (XPUB) or output descriptor.

Example: xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQ
Query parameters
pageintegerOptional

Page number of returned transactions (pagination)

Default: 1Example: 1
pageSizeintegerOptional

Number of transactions returned per page

Default: 1000Example: 500
fromintegerOptional

Start block height filter (inclusive)

Example: 3000000
tointegerOptional

End block height filter (inclusive)

Example: 4000000
detailsstringOptional

Level of transaction detail. Supported: basic, tokens, tokenBalances, txids, txs

Example: txids
Responses
get
/api/v2/xpub/{xpubOrDescriptor}
200

Successful XPUB/Descriptor details response

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
get
/api/v2/sendtx/{hexTxData}
200

Transaction broadcast successfully

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
post
/api/v2/sendtx/
200

Transaction broadcast successfully

Last updated