API Docs

About the API

The API documented below is made available by BitcoinExplorer. All actions return JSON content. The actions are organized by category. From this documentation you can directly click on an action's link to see the output format in your browser.

Note that the output from any given action may vary, depending on the capabilities of your node. BitcoinExplorer does its best to maximize data returned, while also gracefully falling back when data is unavailable (e.g. when older node software simply doesn't have a particular piece of data).

blocks

/api/block/$HASH

Returns the details of the block with the given hash.

/api/block/$HEIGHT

Returns the details of the block at the given height.

/api/block/header/$HASH

Returns the details of the block header with the given hash.

/api/block/header/$HEIGHT

Returns the details of the block header at the given height.

/api/blocks/tip

Returns basic details about the chain tip.

transactions

/api/tx/$TXID

Returns the details of the transaction with the given txid.

blockchain

/api/blockchain/coins

Returns the current supply of Bitcoin. An estimate using a checkpoint can be returned in 2 cases: on 'slow' devices, and before the UTXO Set snapshot is loaded.

/api/blockchain/utxo-set

Returns the latest UTXO Set snapshot. Warning: This call can be very slow, depending on node hardware and index configurations.

/api/blockchain/next-halving

Returns details about the next, upcoming halving.

addresses

/api/address/$ADDRESS

Returns a summary of data pertaining to the given address. The output of this call will depend heavily on the configured 'Address API' (see .env-sample file). If an Address API is configured, transactions related to the given address will be returned (the below optional parameters apply to those transactions).

Optional parameters

limitNumber of transactions to return

offsetOffset into transactions

sortSorting direction for transactions ('desc'=new first, 'asc'=old first)

xpubs

/api/xyzpub/$XPUB

Returns details for the specified extended public key, including related keys and addresses.

Optional parameters

limitThe number of addresses to return

offsetOffset into the list of addresses

/api/xyzpub/addresses/$XPUB

Returns a list of addresses derived from the given [xyz]pub.

Optional parameters

receiveOrChange0 for 'receive' addresses (default); 1 for 'change' addresses

limitNumber of addresses to return

offsetOffset into addresses

/api/xyzpub/txids/$XPUB

Returns a list of transaction IDs associated with the given [xyz]pub.

Optional parameters

gapLimitLimit of empty addresses to end searching for transactions (default: 20)

addressLimitForced limit on the number of addresses to search through (both 'receive' and 'change' addresses up to this number will be searched)

mining

/api/mining/hashrate

Returns the network hash rate, estimated over the last 1, 7, 30, 90, and 365 days.

/api/mining/diff-adj-estimate

Returns the current estimate for the next difficulty adjustment as a percentage.

/api/mining/next-block

Returns a summary for the estimated next block to be mined (produced via getblocktemplate).

/api/mining/next-block/txids

Returns a list of the transaction IDs included in the estimated next block to be mined (produced via getblocktemplate).

/api/mining/next-block/includes/$TXID

Returns whether the specified transaction ID is included in the estimated next block to be mined (produced via getblocktemplate).

/api/mining/miner-summary

Returns whether the specified transaction ID is included in the estimated next block to be mined (produced via getblocktemplate).

Optional parameters

sinceUse the form 'Nd' to specify the number of day to look back (e.g. 'since=7d' will analyze the last 7 days)

startHeight+endHeightUse these 2 parameters to specify a custom start/end height (e.g. 'startHeight=0&endHeight=24' to analyze the first 25 blocks)

mempool

/api/mempool/count

Returns the number of transactions in Bitcoin Core's mempool.

/api/mempool/summary

Returns a summary of Bitcoin Core's mempool (full output from 'getmempoolinfo')

/api/mempool/fees

Returns recommended fee rates in sats/vB for next block, ~30 min, 1 hr, and 1 day.

price

/api/price

Returns the price of 1 BTC, in USD, EUR, GBP, and XAU

Optional parameters

formatSet to 'true' to include thousands-separator formatting in results

/api/price/marketcap

Returns the market cap of Bitcoin, in USD, EUR, GBP, XAU

/api/price/sats

Returns the price of 1 unit of [USD, EUR, GBP, XAU] (e.g. 1 "usd") in satoshis (aka "Moscow Time")

fun

/api/quotes/all

Returns the full curated list of Bitcoin quotes.

/api/quotes/$INDEX

Returns the Bitcoin quote with the given index from the curated list.

/api/quotes/random

Returns a random Bitcoin quote from the curated list.

/api/holidays/all

Returns the full curated list of Bitcoin Holidays.

/api/holidays/today

Returns the Bitcoin Holidays celebrated 'today' (i.e. at the time the API call is made).

Optional parameters

tzOffsetThe number of hours to offset from UTC for the caller's local timezone, e.g. "-5" for EST

/api/holidays/$DAY

Returns the Bitcoin Holidays celebrated on the specified day, using one of the following formats: yyyy-MM-DD, MM-DD.

admin

/api/version

Returns the semantic version of the public API, which is maintained separate from the app version.