Esplora Commands
The esplora namespace provides block explorer functionality for querying blocks, transactions, addresses, and fee estimates via the Electrs/Esplora API.
Try It Live
$ alkanes-cli -p mainnet esplora blocks-tip-height$ alkanes-cli -p mainnet esplora address-utxo bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3hCommands Overview
Block Queries:
blocks-tip-hash- Get the hash of the latest blockblocks-tip-height- Get the height of the latest blockblocks- Get latest blocksblock-height- Get block hash at a heightblock- Get block detailsblock-status- Get block statusblock-txids- Get transaction IDs in a blockblock-header- Get block headerblock-raw- Get raw block datablock-txid- Get transaction at index in blockblock-txs- Get transactions in a block
Address Queries:
address- Get address informationaddress-txs- Get address transactionsaddress-txs-chain- Get confirmed address transactionsaddress-txs-mempool- Get mempool transactions for addressaddress-utxo- Get UTXOs for an addressaddress-prefix- Search addresses by prefix
Transaction Queries:
tx- Get transaction detailstx-hex- Get transaction as hextx-raw- Get raw transaction datatx-status- Get transaction statustx-merkle-proof- Get merkle prooftx-merkleblock-proof- Get merkleblock prooftx-outspend- Get outpoint spending infotx-outspends- Get all output spending info
Broadcasting:
broadcast- Broadcast a transactionpost-tx- Post a transaction
Mempool:
mempool- Get mempool infomempool-txids- Get mempool transaction IDsmempool-recent- Get recent mempool transactions
Fees:
fee-estimates- Get fee rate estimates
esplora blocks-tip-height
Get the current blockchain tip height.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora blocks-tip-height
Output:
Tip Height: 850123
esplora blocks-tip-hash
Get the hash of the latest block.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora blocks-tip-hash
esplora block
Get details for a specific block.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora block 840000
Arguments:
<BLOCK_HASH_OR_HEIGHT>- Block hash or height
esplora block-txids
Get all transaction IDs in a block.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora block-txids 840000
esplora address
Get information about a Bitcoin address.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora address bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h
Arguments:
<ADDRESS>- Bitcoin address
esplora address-utxo
Get unspent transaction outputs (UTXOs) for an address.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora address-utxo bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h
Arguments:
<ADDRESS>- Bitcoin address
Example Response:
[
{
"txid": "abc123...",
"vout": 0,
"value": 10000,
"status": {
"confirmed": true,
"block_height": 840000
}
}
]
esplora address-txs
Get transactions for an address.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora address-txs bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h
esplora address-txs-mempool
Get unconfirmed (mempool) transactions for an address.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora address-txs-mempool bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h
esplora tx
Get transaction details.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora tx <TXID>
Arguments:
<TXID>- Transaction ID
esplora tx-hex
Get transaction as hexadecimal.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora tx-hex <TXID>
esplora tx-status
Get transaction confirmation status.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora tx-status <TXID>
esplora tx-outspend
Check if a specific output has been spent.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora tx-outspend <TXID> <VOUT>
Arguments:
<TXID>- Transaction ID<VOUT>- Output index
esplora fee-estimates
Get current fee rate estimates for different confirmation targets.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora fee-estimates
Example Response:
{
"1": 25.5,
"3": 20.0,
"6": 15.2,
"25": 10.0,
"144": 5.0,
"504": 3.0
}
The keys represent confirmation target in blocks, values are fee rates in sat/vB.
esplora broadcast
Broadcast a signed transaction to the network.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora broadcast <TX_HEX>
Arguments:
<TX_HEX>- Signed transaction as hexadecimal
esplora mempool
Get mempool statistics.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora mempool
esplora mempool-txids
Get all transaction IDs in the mempool.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora mempool-txids
esplora mempool-recent
Get recent mempool transactions.
alkanes-cli -p mainnet \
--jsonrpc-url https://mainnet.subfrost.io/v4/jsonrpc \
esplora mempool-recent
JSON-RPC Equivalent
These CLI commands correspond to JSON-RPC methods with the esplora_ prefix:
esplora address-utxo→esplora_address::utxoesplora fee-estimates→esplora_fee-estimatesesplora blocks-tip-height→esplora_blocks:tip:height
Example JSON-RPC:
{
"jsonrpc": "2.0",
"method": "esplora_address::utxo",
"params": ["bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h"],
"id": 1
}
Next Steps
- Ord Commands - Ordinals queries
- BRC20-Prog Commands - EVM contract operations
- DataAPI Commands - High-level data queries