Index

Get Blockbook backend info

get

Returns general metadata and status about the Blockbook service and its connected backend node.

Authorizations
api-keystringRequired
Responses
chevron-right
200

Successfully retrieved Blockbook info

application/json
get
/api

Get block hash by block height

get

Returns the block hash corresponding to the specified block height.

Authorizations
api-keystringRequired
Path parameters
heightintegerRequired

The height of the block (e.g., 800000)

Example: 800000
Responses
chevron-right
200

Successfully retrieved block hash

application/json
blockHashstringOptional

The hash of the block at the specified height

Example: 00000000000000000004e6a25d5e8bb4d9b23f94b84f8e0cf4e2128c2b93a6b1
get
/api/v2/block-index/{height}

Get specific transaction details

get

Returns full decoded transaction data for a given transaction ID.

Authorizations
api-keystringRequired
Path parameters
txidstringRequired

Transaction ID (txid) to look up

Example: f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a
Responses
chevron-right
200

Successful response with transaction details

application/json
txidstringOptional

The transaction ID (txid) of the transaction.

hashstringOptional

The transaction hash (includes witness data).

versionintegerOptional

Version number of the transaction format.

sizeintegerOptional

Total size of the transaction in bytes.

vsizeintegerOptional

Virtual size (vsize) for segwit-enabled transactions.

weightintegerOptional

Transaction weight (used in fee calculation).

locktimeintegerOptional

Locktime of the transaction (usually 0 unless time-locked).

hexstringOptional

Raw hexadecimal representation of the transaction.

blockhashstringOptional

Hash of the block containing this transaction.

confirmationsintegerOptional

Number of confirmations this transaction has received.

timeintegerOptional

Unix timestamp of the transaction.

blocktimeintegerOptional

Block timestamp when transaction was included.

get
/api/v2/tx-specific/{txid}

Get address information

get

Returns detailed information about a Optimism address such as balance, total received and sent, unconfirmed transactions, list of txids, and more. Supports pagination and filtering by block height and details.

Authorizations
api-keystringRequired
Path parameters
addressstringRequired

Optimism address to query.

Example: bc1qll4224u6ecldm02xs250h20ax9u6dc4pl9332d
Query parameters
pageintegerOptional

Page number for pagination (default is 1).

Default: 1
pageSizeintegerOptional

Number of items per page (default 1000).

Default: 1000
fromintegerOptional

Starting block height to filter transactions (optional).

tointegerOptional

Ending block height to filter transactions (optional).

detailsstring · enumOptional

Level of transaction detail to return. Options:

  • basic: Basic transaction info.
  • tokens: Include token info.
  • tokenBalances: Include token balances.
  • txids: Return only transaction IDs.
  • txs: Return full transaction details.
Possible values:
contractstringOptional

Filter by contract address (optional).

secondarystringOptional

Include secondary currency balances (e.g., USD).

Example: usd
Responses
chevron-right
200

Successful response with address details

application/json
pageintegerOptional

Current page number.

totalPagesintegerOptional

Total number of pages available.

itemsOnPageintegerOptional

Number of items on the current page.

addressstringOptional

Queried Optimism address.

balancestringOptional

Confirmed balance of the address (in satoshis).

totalReceivedstringOptional

Total amount ever received by the address (in satoshis).

totalSentstringOptional

Total amount ever sent from the address (in satoshis).

unconfirmedBalancestringOptional

Unconfirmed balance (in satoshis).

unconfirmedTxsintegerOptional

Number of unconfirmed transactions related to this address.

txsintegerOptional

Total number of transactions related to this address.

txidsstring[]Optional

List of transaction IDs involving this address.

get
/api/v2/address/{address}

Get XPUB or descriptor details

get

Retrieves detailed information about an XPUB or descriptor including confirmed balance, total received and sent amounts, unconfirmed balances, transaction counts, tokens used, and paginated transaction IDs.

Authorizations
api-keystringRequired
Path parameters
xpubOrDescriptorstringRequired

XPUB or descriptor to query.

Example: xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB
Query parameters
pageintegerOptional

Page number for pagination (default is 1).

Default: 1
pageSizeintegerOptional

Number of items per page (default 1000).

Default: 1000
fromintegerOptional

Starting block height to filter transactions (optional).

tointegerOptional

Ending block height to filter transactions (optional).

detailsstring · enumOptional

Level of transaction detail to return. Options:

  • basic: Basic transaction info.
  • tokens: Include token info.
  • tokenBalances: Include token balances.
  • txids: Return only transaction IDs.
  • txs: Return full transaction details.
Possible values:
tokensstring · enumOptional

Filter tokens by usage type:

  • nonzero: Tokens with non-zero balances.
  • used: Tokens that have been used.
  • derived: Tokens derived from this XPUB.
Possible values:
secondarystringOptional

Include secondary currency balances (e.g., EUR).

Example: eur
Responses
chevron-right
200

Successful response with XPUB details

application/json
pageintegerOptional

Current page number.

totalPagesintegerOptional

Total number of pages available.

itemsOnPageintegerOptional

Number of items on the current page.

addressstringOptional

XPUB or descriptor queried.

balancestringOptional

Confirmed balance (in satoshis).

totalReceivedstringOptional

Total amount ever received (in satoshis).

totalSentstringOptional

Total amount ever sent (in satoshis).

unconfirmedBalancestringOptional

Unconfirmed balance (in satoshis).

unconfirmedTxsintegerOptional

Number of unconfirmed transactions.

txsintegerOptional

Total number of transactions.

addrTxCountintegerOptional

Number of address transactions related to this XPUB.

txidsstring[]Optional

List of transaction IDs related to this XPUB.

usedTokensintegerOptional

Number of tokens used by this XPUB.

get
/api/v2/xpub/{xpubOrDescriptor}

Get UTXOs for address, XPUB or descriptor

get

Retrieves the unspent transaction outputs (UTXOs) associated with a specific address, XPUB, or descriptor. Optionally filter only confirmed UTXOs by using the confirmed query parameter.

Authorizations
api-keystringRequired
Path parameters
addressOrXpubOrDescriptorstringRequired

Address, XPUB or descriptor to query UTXOs for.

Example: bc1qll4224u6ecldm02xs250h20ax9u6dc4pl9332d
Query parameters
confirmedbooleanOptional

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

Default: false
Responses
chevron-right
200

List of UTXOs for the given address, XPUB, or descriptor

application/json
txidstringOptional

Transaction ID of the UTXO.

Example: 99446b8a7d2d61301ef6d4e34d65ee179da9d15daec46d8ca746ce9984ba31d1
voutintegerOptional

Output index in the transaction.

Example: 0
valuestringOptional

Value of the UTXO in satoshis.

Example: 4555309
heightintegerOptional

Block height where the UTXO was confirmed.

Example: 700000
confirmationsintegerOptional

Number of confirmations for this UTXO.

Example: 100
coinbasebooleanOptional

Indicates if the UTXO is from a coinbase transaction.

Example: false
spentbooleanOptional

Indicates if the UTXO has already been spent.

Example: false
get
/api/v2/utxo/{addressOrXpubOrDescriptor}

Get block details by height or hash

get

Returns detailed information about a block specified by its height or hash.

Authorizations
api-keystringRequired
Path parameters
blockHeightOrHashstringRequired

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

Example: 0000000000000000000a1b2c3d4e5f67890abcdef1234567890abcdef1234567
Responses
chevron-right
200

Block details response

application/json
hashstringOptional

The hash of the block.

Example: 0000000000000000000a1b2c3d4e5f67890abcdef1234567890abcdef1234567
confirmationsintegerOptional

Number of confirmations of the block.

Example: 123
sizeintegerOptional

Size of the block in bytes.

Example: 1234567
heightintegerOptional

Block height (block number).

Example: 700000
versionintegerOptional

Block version.

Example: 536870912
merklerootstringOptional

Merkle root of the transactions in the block.

Example: 4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
txstring[]Optional

List of transaction IDs included in the block.

Example: ["f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a","cbc797f38d2451d82abcf87a34411dfc2301013bfb2e02e603f23f79162f06e9"]
timeintegerOptional

Timestamp of the block in UNIX epoch time.

Example: 1753349199
nonceintegerOptional

Nonce used for mining the block.

Example: 2083236893
bitsstringOptional

Encoded difficulty target of the block.

Example: 1d00ffff
difficultynumber · doubleOptional

Difficulty value of the block.

Example: 19354847804972.85
previousblockhashstringOptional

Hash of the previous block in the chain.

Example: 0000000000000000000872af0a1b2c3d4e5f67890abcdef1234567890abcdef1
nextblockhashstringOptional

Hash of the next block in the chain (if available).

Example: 0000000000000000000b3c4d5e6f7890abcdef1234567890abcdef1234567890
get
/api/v2/block/{blockHeightOrHash}

Broadcast raw transaction

get

Sends a raw transaction to the blockchain network. The transaction must be provided as a hex-encoded string in the URL path.

Authorizations
api-keystringRequired
Path parameters
hexTxDatastringRequired

Hex-encoded raw transaction data to be broadcasted.

Example: 0100000001abcdef...00000000
Responses
chevron-right
200

Transaction broadcast successful

application/json
txidstringOptional

Transaction ID (hash) of the broadcasted transaction.

Example: f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a
resultstringOptional

Status message of the broadcast.

Example: Transaction broadcasted successfully
get
/api/v2/sendtx/{hexTxData}

Get list of tickers updated since timestamp

get

Returns an array of ticker objects representing cryptocurrency prices updated since the specified UNIX timestamp (in seconds).

Authorizations
api-keystringRequired
Query parameters
timestampintegerOptional

UNIX timestamp (in seconds). Only tickers updated after this time are returned.

Example: 1680000000
Responses
chevron-right
200

List of tickers

application/json
symbolstringOptional

Ticker symbol of the cryptocurrency.

Example: BTC
pricestringOptional

Current price of the cryptocurrency in USD.

Example: 26859.45
timestampintegerOptional

UNIX timestamp (seconds) when the price was last updated.

Example: 1680001234
get
/api/v2/tickers-list

Get balance history for an address or XPUB

get

Returns the balance history for the specified address or XPUB between the from and to date parameters. The balances can be optionally converted to a specified fiat currency and grouped by time intervals.

Authorizations
api-keystringRequired
Path parameters
accountstringRequired

XPUB or address to query balance history for

Example: xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB
Query parameters
fromstring · date-timeRequired

Start date (ISO 8601 format, e.g. 2023-01-01T00:00:00Z)

Example: 2023-01-01T00:00:00Z
tostring · date-timeRequired

End date (ISO 8601 format, e.g. 2023-01-10T00:00:00Z)

Example: 2023-01-10T00:00:00Z
fiatcurrencystringOptional

Fiat currency code to convert balances (e.g., USD, EUR). Optional.

Example: USD
groupByintegerOptional

Group results by time interval in seconds (e.g., 86400 for daily). Optional.

Example: 86400
Responses
chevron-right
200

Balance history retrieved successfully

application/json
accountstringOptional

XPUB or address queried

Example: xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB
fromstring · date-timeOptional

Start date of the history

Example: 2023-01-01T00:00:00Z
tostring · date-timeOptional

End date of the history

Example: 2023-01-10T00:00:00Z
fiatcurrencystring · nullableOptional

Fiat currency code if conversion applied

Example: USD
groupByinteger · nullableOptional

Grouping interval in seconds if applied

Example: 86400
get
/api/v2/balancehistory/{account}

Last updated