btc-rpc-explorer
Version:
Open-source, self-hosted Bitcoin explorer
271 lines (227 loc) • 8.28 kB
JavaScript
module.exports = {
"version": "2.0.0",
"baseUrl": "/api",
"routes":[
// blocks
{
"category":"blocks",
"url":"/block/$HASH",
"desc":"Returns the details of the block with the given hash.",
"testUrl":"/block/0000000000000000001c8018d9cb3b742ef25114f27563e3fc4a1902167f9893"
},
{
"category":"blocks",
"url":"/block/$HEIGHT",
"desc":"Returns the details of the block at the given height.",
"testUrl":"/block/123456"
},
{
"category":"blocks",
"url":"/block/header/$HASH",
"desc":"Returns the details of the block header with the given hash.",
"testUrl":"/block/header/0000000000000000001c8018d9cb3b742ef25114f27563e3fc4a1902167f9893"
},
{
"category":"blocks",
"url":"/block/header/$HEIGHT",
"desc":"Returns the details of the block header at the given height.",
"testUrl":"/block/header/123456"
},
{
"category":"blocks",
"url":"/blocks/tip",
"desc":"Returns basic details about the chain tip."
},
// transactions
{
"category":"transactions",
"url":"/tx/$TXID",
"desc":"Returns the details of the transaction with the given txid.",
"testUrl": "/tx/f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16"
},
{
"category":"transactions",
"url":"/tx/volume/24h",
"desc":"Returns total output of all transactions over the last 24hrs.",
"testUrl": "/tx/volume/24h",
"hideInSlowMode": true
},
// blockchain
{
"category":"blockchain",
"url":"/blockchain/coins",
"desc":"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."
},
{
"category":"blockchain",
"url":"/blockchain/utxo-set",
"desc":"Returns the latest UTXO Set snapshot. Warning: This call can be very slow, depending on node hardware and index configurations."
},
{
"category":"blockchain",
"url":"/blockchain/next-halving",
"desc":"Returns details about the next, upcoming halving."
},
// addresses
{
"category":"addresses",
"url":"/address/$ADDRESS",
"desc":"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).",
"optionalParams": {
"limit":"Number of transactions to return",
"offset":"Offset into transactions",
"sort":"Sorting direction for transactions ('desc'=new first, 'asc'=old first)"
},
"testUrl":"/address/34rng4QwB5pHUbGDJw1JxjLwgEU8TQuEqv"
},
// xyz-pubs
{
"category":"xpubs",
"url":"/xyzpub/$XPUB",
"desc":"Returns details for the specified extended public key, including related keys and addresses.",
"optionalParams": {
"limit":"The number of addresses to return",
"offset":"Offset into the list of addresses"
},
"testUrl": "/util/xyzpub/xpub6EuV33a2DXxAhoJTRTnr8qnysu81AA4YHpLY6o8NiGkEJ8KADJ35T64eJsStWsmRf1xXkEANVjXFXnaUKbRtFwuSPCLfDdZwYNZToh4LBCd"
},
{
"category":"xpubs",
"url":"/xyzpub/addresses/$XPUB",
"desc":"Returns a list of addresses derived from the given [xyz]pub.",
"optionalParams": {
"receiveOrChange":"0 for 'receive' addresses (default); 1 for 'change' addresses",
"limit":"Number of addresses to return",
"offset":"Offset into addresses"
},
"testUrl":"/xyzpub/addresses/xpub6EuV33a2DXxAhoJTRTnr8qnysu81AA4YHpLY6o8NiGkEJ8KADJ35T64eJsStWsmRf1xXkEANVjXFXnaUKbRtFwuSPCLfDdZwYNZToh4LBCd"
},
{
"category":"xpubs",
"url":"/xyzpub/txids/$XPUB",
"desc":"Returns a list of transaction IDs associated with the given [xyz]pub.",
"optionalParams": {
"gapLimit":"Limit of empty addresses to end searching for transactions (default: 20)",
"addressLimit":"Forced limit on the number of addresses to search through (both 'receive' and 'change' addresses up to this number will be searched)"
},
"testUrl":"/xyzpub/txids/xpub6EuV33a2DXxAhoJTRTnr8qnysu81AA4YHpLY6o8NiGkEJ8KADJ35T64eJsStWsmRf1xXkEANVjXFXnaUKbRtFwuSPCLfDdZwYNZToh4LBCd"
},
// mining
{
"category":"mining",
"url":"/mining/hashrate",
"desc":"Returns the network hash rate, estimated over the last 1, 7, 30, 90, and 365 days."
},
{
"category":"mining",
"url":"/mining/diff-adj-estimate",
"desc":"Returns the current estimate for the next difficulty adjustment as a percentage."
},
{
"category":"mining",
"url":"/mining/next-block",
"desc":"Returns a summary for the estimated next block to be mined (produced via getblocktemplate)."
},
{
"category":"mining",
"url":"/mining/next-block/txids",
"desc":"Returns a list of the transaction IDs included in the estimated next block to be mined (produced via getblocktemplate)."
},
{
"category":"mining",
"url":"/mining/next-block/includes/$TXID",
"desc":"Returns whether the specified transaction ID is included in the estimated next block to be mined (produced via getblocktemplate).",
"testUrl":"/mining/next-block/includes/yourTxId"
},
{
"category":"mining",
"url":"/mining/miner-summary",
"desc":"Returns whether the specified transaction ID is included in the estimated next block to be mined (produced via getblocktemplate).",
"optionalParams": {
"since":"Use the form 'Nd' to specify the number of day to look back (e.g. 'since=7d' will analyze the last 7 days)",
"startHeight+endHeight":"Use these 2 parameters to specify a custom start/end height (e.g. 'startHeight=0&endHeight=24' to analyze the first 25 blocks)"
},
"testUrl":"/mining/miner-summary?since=1d"
},
// mempool
{
"category":"mempool",
"url":"/mempool/count",
"desc":"Returns the number of transactions in Bitcoin Core's mempool."
},
{
"category":"mempool",
"url":"/mempool/summary",
"desc":"Returns a summary of Bitcoin Core's mempool (full output from 'getmempoolinfo')",
"example": {"loaded":true,"size":225,"bytes":76209,"usage":410496,"total_fee":0.01763495,"maxmempool":15000000,"mempoolminfee":0.00001,"minrelaytxfee":0.00001,"unbroadcastcount":0}
},
{
"category":"mempool",
"url":"/mempool/fees",
"desc":"Returns recommended fee rates in sats/vB for next block, ~30 min, 1 hr, and 1 day.",
"example": {"nextBlock":17,"30min":9,"60min":9,"1day":9}
},
// price
{
"category":"price",
"url":"/price",
"desc":"Returns the price of 1 BTC, in USD, EUR, GBP, and XAU",
"optionalParams": {
"format":"Set to 'true' to include thousands-separator formatting in results"
}
},
{
"category":"price",
"url":"/price/marketcap",
"desc":"Returns the market cap of Bitcoin, in USD, EUR, GBP, XAU",
},
{
"category":"price",
"url":"/price/sats",
"desc":"Returns the price of 1 unit of [USD, EUR, GBP, XAU] (e.g. 1 \"usd\") in satoshis (aka \"Moscow Time\")",
},
// fun
{
"category":"fun",
"url":"/quotes/all",
"desc":"Returns the full curated list of Bitcoin quotes.",
},
{
"category":"fun",
"url":"/quotes/$INDEX",
"desc":"Returns the Bitcoin quote with the given index from the curated list.",
"testUrl": "/quotes/0"
},
{
"category":"fun",
"url":"/quotes/random",
"desc":"Returns a random Bitcoin quote from the curated list."
},
{
"category":"fun",
"url":"/holidays/all",
"desc":"Returns the full curated list of Bitcoin Holidays."
},
{
"category":"fun",
"url":"/holidays/today",
"desc":"Returns the Bitcoin Holidays celebrated 'today' (i.e. at the time the API call is made).",
"optionalParams": {
"tzOffset":"The number of hours to offset from UTC for the caller's local timezone, e.g. \"-5\" for EST"
},
"testUrl": "/holidays/today?tzOffset=-5"
},
{
"category":"fun",
"url":"/holidays/$DAY",
"desc":"Returns the Bitcoin Holidays celebrated on the specified day, using one of the following formats: yyyy-MM-DD, MM-DD.",
"testUrl": "/holidays/01-03"
},
// admin
{
"category":"admin",
"url":"/version",
"desc":"Returns the semantic version of the public API, which is maintained separate from the app version."
},
]
}