Loading explorer data...
Loading explorer data...
The BTQ Explorer API provides read-only access to indexed blockchain data. All endpoints return JSON and accept GET requests unless noted otherwise.
https://explorer.bitcoinquantum.com/api/v1Query block data from the indexed blockchain.
/api/v1/blocksReturns a paginated list of blocks, ordered by height descending.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | no (1) | Page number |
| limit | integer | no (20) | Results per page (max 100) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/blocks?page=1&limit=5"
Example Response
{
"items": [{ "hash": "00000f...", "height": 14520, "tx_count": 3, ... }],
"total": 14520,
"page": 1,
"limit": 5
}/api/v1/blocks/tipReturns the most recent block (chain tip).
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/blocks/tip"
Example Response
{
"hash": "00000f...",
"height": 14520,
"timestamp": "2025-12-01T12:34:56Z",
"tx_count": 5,
"difficulty": "1234567.89",
...
}/api/v1/block/:heightOrHashReturns full details for a specific block by height (integer) or hash (64-char hex).
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| heightOrHash | string | yes | Block height (e.g. 14520) or block hash (64-char hex) |
Example Request
# By height
curl "https://explorer.bitcoinquantum.com/api/v1/block/14520"
# By hash
curl "https://explorer.bitcoinquantum.com/api/v1/block/00000f..."
/api/v1/block/:heightOrHash/txsReturns paginated transactions for a given block.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| heightOrHash | string | yes | Block height or block hash |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | no (1) | Page number |
| limit | integer | no (25) | Results per page (max 100) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/block/14520/txs?page=1&limit=10"
Look up individual transactions or recent activity.
/api/v1/tx/:txidReturns full transaction details including decoded inputs, outputs, and addresses.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| txid | string | yes | Transaction ID (64-char hex) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/tx/a1b2c3d4e5f6..."
Example Response
{
"txid": "a1b2c3...",
"block_height": 14520,
"fee": "1000",
"is_dilithium": false,
"inputs": [...],
"outputs": [...]
}/api/v1/txs/recentReturns the most recent transactions across all blocks.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (10) | Number of transactions (max 50) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/txs/recent?limit=5"
Query address balances, transaction history, and UTXOs.
/api/v1/address/:addressReturns summary data for an address including balance, transaction count, and Dilithium status.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | yes | BTQ address |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/address/btq1qxyz..."
Example Response
{
"address": "btq1q...",
"balance": "500000000",
"tx_count": 42,
"total_received": "1000000000",
"total_sent": "500000000",
"isDilithium": true
}/api/v1/address/:address/txsReturns paginated transaction history for an address.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | yes | BTQ address |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | no (1) | Page number |
| limit | integer | no (25) | Results per page (max 100) |
| sort | string | no (desc) | Sort order: "asc" (oldest first) or "desc" (newest first) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/address/btq1qxyz.../txs?page=1&limit=10&sort=desc"
/api/v1/address/:address/utxosReturns unspent transaction outputs (UTXOs) for an address.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | yes | BTQ address |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (100) | Maximum UTXOs to return (max 500) |
| offset | integer | no (0) | Offset for pagination |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/address/btq1qxyz.../utxos?limit=50"
Blockchain statistics, supply data, rich list, and Dilithium adoption metrics.
/api/v1/stats/summaryReturns a high-level overview of the blockchain: tip height, difficulty, transaction count, active addresses, mempool size, and indexer health. Compare tipHeight with nodeHeight to tell a stalled chain from an indexer that has fallen behind; lastReconciledAt stops advancing if the indexer dies.
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/stats/summary"
Example Response
{
"tipHeight": 14520,
"tipHash": "00000f...",
"difficulty": "1234567.89",
"totalTransactions": 52340,
"activeAddresses": 8712,
"mempoolSize": 15,
"indexerStatus": "live",
"nodeHeight": 14520,
"tipMatch": true,
"lastReconciledAt": "2026-09-04T11:02:14.881Z"
}/api/v1/stats/supplyReturns circulating supply (from UTXO set), UTXO count, and maximum supply.
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/stats/supply"
Example Response
{
"circulatingSupply": "1050000000000000",
"utxoCount": 48210,
"maxSupply": "2100000000000000"
}/api/v1/stats/richlistReturns the top addresses by balance.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | no (1) | Page number |
| limit | integer | no (100) | Results per page (max 500) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/stats/richlist?page=1&limit=10"
/api/v1/stats/dailyReturns daily aggregated statistics (blocks, transactions, fees, addresses, difficulty, hashrate).
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| from | string | no | Start date (YYYY-MM-DD) |
| to | string | no | End date (YYYY-MM-DD) |
| limit | integer | no (30) | Number of days (max 365) |
Example Request
# Last 7 days
curl "https://explorer.bitcoinquantum.com/api/v1/stats/daily?limit=7"
# Date range
curl "https://explorer.bitcoinquantum.com/api/v1/stats/daily?from=2025-01-01&to=2025-01-31"
/api/v1/stats/dilithiumReturns current Dilithium (post-quantum) adoption statistics: transaction and address counts with percentages.
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/stats/dilithium"
Example Response
{
"dilithiumTransactions": 1234,
"totalTransactions": 52340,
"dilithiumAddresses": 456,
"totalAddresses": 8712,
"dilithiumTxPercent": "2.36",
"dilithiumAddrPercent": "5.23"
}/api/v1/stats/dilithium/historyReturns daily Dilithium adoption history.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (30) | Number of days (max 365) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/stats/dilithium/history?limit=14"
Inspect unconfirmed transactions waiting in the mempool.
/api/v1/mempool/summaryReturns mempool overview: transaction count, total vsize, total fees, and a fee-rate histogram.
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/mempool/summary"
Example Response
{
"txCount": 15,
"totalVsize": 4520,
"totalFees": "25000",
"feeHistogram": [
{ "bucket": "1-5", "count": 8, "totalVsize": 2100 },
{ "bucket": "5-10", "count": 5, "totalVsize": 1800 }
]
}/api/v1/mempool/txsReturns recent unconfirmed transactions from the mempool.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (20) | Number of transactions (max 100) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/mempool/txs?limit=5"
Mining pool distribution, difficulty, and hashrate data.
/api/v1/mining/poolsReturns mining pool distribution over a recent block window.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| window | integer | no (1440) | Number of recent blocks to analyze (max 10,000) |
Example Request
# Last 1440 blocks (~24h)
curl "https://explorer.bitcoinquantum.com/api/v1/mining/pools"
# Last 100 blocks
curl "https://explorer.bitcoinquantum.com/api/v1/mining/pools?window=100"
/api/v1/mining/difficultyReturns recent block difficulty values, optionally limited to a trailing time window or an inclusive from/to date range.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (2000) | Number of blocks (max 20,160) |
| windowMinutes | integer | no | Only blocks in the last N minutes (max 10,080) |
| from | string | no | Inclusive start date (YYYY-MM-DD). Use with to. |
| to | string | no | Inclusive end date (YYYY-MM-DD). Use with from. |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/mining/difficulty?from=2026-09-01&to=2026-09-07&limit=2000"
/api/v1/mining/hashrateReturns daily estimated hashrate and average difficulty.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (30) | Number of days (max 365) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/mining/hashrate?limit=7"
/api/v1/mining/network-hashrateReturns the estimated network hashrate over a recent block window (default 1440 blocks, ~24h at 1-minute spacing).
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| window | integer | no (1440) | Number of recent canonical blocks (2–10,080) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/mining/network-hashrate"
Example Response
{
"hashrate": "12400000000000",
"window": 1440,
"blockCount": 1440,
"elapsedSeconds": 86120
}Unified search across blocks, transactions, and addresses.
/api/v1/searchSearches by block height, block hash, transaction ID, or address. Returns the match type and value.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | yes | Search query (block height, hash, txid, or address) |
Example Request
# Search by block height
curl "https://explorer.bitcoinquantum.com/api/v1/search?q=14520"
# Search by address
curl "https://explorer.bitcoinquantum.com/api/v1/search?q=btq1qxyz..."
Example Response
{
"type": "address",
"value": "btq1q...",
"query": "btq1q..."
}Whale alerts, address labels, and OP_RETURN data.
/api/v1/whale-alertsReturns large-value transactions that exceed a configurable threshold.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (20) | Number of alerts (max 100) |
| minValue | string | no (100000000000 (1000 BTQ)) | Minimum value in satoshis |
Example Request
# Default threshold (1000 BTQ)
curl "https://explorer.bitcoinquantum.com/api/v1/whale-alerts?limit=10"
# Custom threshold (500 BTQ = 50000000000 sats)
curl "https://explorer.bitcoinquantum.com/api/v1/whale-alerts?limit=10&minValue=50000000000"
/api/v1/label/:addressReturns the label for a known address (e.g. exchange, mining pool).
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | yes | BTQ address |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/label/btq1qxyz..."
/api/v1/labelsReturns all known address labels, optionally filtered by category.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| category | string | no | Filter by label category |
| limit | integer | no (100) | Maximum labels to return (max 500) |
Example Request
# All labels
curl "https://explorer.bitcoinquantum.com/api/v1/labels?limit=50"
# Filter by category
curl "https://explorer.bitcoinquantum.com/api/v1/labels?category=exchange&limit=50"
/api/v1/op-returnsReturns recent OP_RETURN outputs embedded in the blockchain.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | no (50) | Number of results (max 100) |
| offset | integer | no (0) | Offset for pagination |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/op-returns?limit=20"
/api/v1/op-return/:txidReturns OP_RETURN data for a specific transaction.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| txid | string | yes | Transaction ID (64-char hex) |
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/op-return/a1b2c3d4e5f6..."
Real-time streaming of blockchain events via WebSocket.
/api/v1/wsConnect to the WebSocket endpoint for real-time updates. Subscribe to channels by sending JSON messages. Available channels: blocks, mempool, stats, whale-alerts. Send {"type":"ping"} to keep alive.
Example Request
# Connect with wscat
wscat -c "wss://explorer.bitcoinquantum.com/ws"
# Then send a subscription message:
> {"type": "subscribe", "channel": "blocks"}
Example Response
// Block event received:
{
"channel": "blocks",
"data": { "height": 14521, "hash": "00000f...", "tx_count": 4 }
}
// Mempool event received:
{
"channel": "mempool",
"data": { "txid": "a1b2c3...", "fee": "1500", "vsize": 225 }
}Health checks and monitoring.
/healthReturns API health status including database connectivity and WebSocket client count. Note: this endpoint is at the root, not under /api/v1.
Example Request
curl "https://explorer.bitcoinquantum.com/health"
Example Response
{
"status": "ok",
"service": "btq-explorer-api",
"database": "connected",
"wsClients": 3
}/api/v1/node/healthReturns node host telemetry for monitoring agents: datadir disk usage, mempool pressure, peer counts and node uptime. Answers 503 when the node cannot be reached. The datadir fields are null unless the API runs on the node host with read access to it. Send `Authorization: Bearer <token>` when the deployment sets HEALTH_API_TOKEN.
Example Request
curl "https://explorer.bitcoinquantum.com/api/v1/node/health"
Example Response
{
"disk": {
"blockchain_size": 42875392112,
"datadir_free_bytes": 391284998144,
"datadir_total_bytes": 1081101176832,
"datadir_free_pct": 36.19
},
"mempool": {
"size": 15,
"bytes": 4821,
"usage": 24960,
"maxmempool": 300000000,
"mempoolminfee": 0.00001,
"unbroadcastcount": 0
},
"peers": { "connections": 8, "connections_in": 3, "connections_out": 5 },
"uptime": 864213
}/metricsReturns Prometheus-formatted metrics for monitoring. Note: this endpoint is at the root, not under /api/v1.
Example Request
curl "https://explorer.bitcoinquantum.com/metrics"
Example Response
# HELP btq_api_db_pool_total Total DB pool connections
# TYPE btq_api_db_pool_total gauge
btq_api_db_pool_total 10
btq_api_ws_clients 3The API enforces rate limiting of 100 requests per minute per IP address. Exceeding this limit returns a 429 status code.
All errors return a JSON object with an error field.
| Status | Meaning |
|---|---|
| 400 | Bad request — invalid parameter format |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
| 503 | Service degraded — database unavailable |