Skip to content
QuantascanAlpha
Browse API groups

Mining API

Proof-of-Work mining on the QRL legacy chain: block-reward emission, difficulty, hashrate, and the top miners and pools.
GET/api/v1/qrl/mining/block-reward-dailyQRL (PoW)

Daily block-reward emission (subsidy + fees)

Per-day mined emission (shor): protocol subsidy vs collected fees.

Query parameters

NameTypeRequiredDefaultDescription
windowstringno90dLook-back window for mining timelines. Default 90d.

Response 200 · BlockRewardDailyList

itemsBlockRewardDailyItem[]
daystringrequired
block_countinteger
subsidy_shorstring
fees_shorstring
total_reward_shorstring
countinteger

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/block-reward-daily" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "items": [],
  "count": 0
}
GET/api/v1/qrl/mining/network-stats-dailyQRL (PoW)

Daily difficulty & hashrate (node-RPC)

Per-day average/max difficulty + hash power from GetStats snapshots. Empty until the mining-stats poller has accumulated history.

Query parameters

NameTypeRequiredDefaultDescription
windowstringno90dLook-back window for mining timelines. Default 90d.

Response 200 · NetworkStatsDailyList

itemsNetworkStatsDailyItem[]
daystringrequired
avg_difficultynumber
avg_hash_powernumber
max_difficultynumber
max_hash_powernumber
countinteger

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/network-stats-daily" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "items": [
    {
      "day": "2026-06-20",
      "avg_difficulty": 3605170104.47,
      "avg_hash_power": 3006680502.1866665,
      "max_difficulty": 4012338895,
      "max_hash_power": 5079778304
    },
    {
      "day": "2026-06-21",
      "avg_difficulty": 4163518437.4215097,
      "avg_hash_power": 4886689185.637467,
      "max_difficulty": 4552772180,
      "max_hash_power": 10115957760
    },
    "… (15 more)"
  ],
  "count": 17
}
GET/api/v1/qrl/mining/pool-distributionQRL (PoW)

Pool / miner block-share distribution (donut)

Share of blocks mined per top-N pool/miner over the window, with the tail bucketed as 'Other miners'.

Query parameters

NameTypeRequiredDefaultDescription
windowstringno30d
topintegermin 3 · max 20no10

Response 200 · PoolDistribution

itemsPoolDistributionItem[]
addressstringrequired
labelstring | null
wallet_classstring
blocks_minedinteger
reward_shorstring
sharenumber
windowstring
total_blocksinteger
total_reward_shorstring

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/pool-distribution" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "items": [],
  "window": "30d",
  "total_blocks": 0,
  "total_reward_shor": "0"
}
GET/api/v1/qrl/mining/pool-dominance-dailyQRL (PoW)

Pool dominance over time (stacked)

Per-day blocks mined by each top-N pool + an 'other' bucket — for a stacked decentralization-over-time chart.

Query parameters

NameTypeRequiredDefaultDescription
topintegermin 3 · max 12no8
windowstringno90dLook-back window for mining timelines. Default 90d.

Response 200 · PoolDominanceResponse

seriesPoolDominanceSeries[]
keystringrequired
labelstringrequired
wallet_classstring
pointsPoolDominancePoint[]
daystringrequired
valuesinteger[]
countinteger

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/pool-dominance-daily" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "series": [],
  "points": [],
  "count": 0
}
GET/api/v1/qrl/mining/summaryQRL (PoW)

Mining KPI summary

Network-health KPIs: difficulty, hashrate, block time, emission, miner/pool counts. Network-health fields are None until the mining-stats poller runs.

Response 200 · MiningSummary

chainstring
networkstring
difficultystring | null
hash_powernumber | null
block_time_meaninteger | null
block_time_sdinteger | null
block_last_reward_shorstring | null
coins_emitted_shorstring | null
max_supply_qrlstring | null
emission_pctnumber | null
stats_updated_atstring | null
total_blocksinteger | null
last_block_timestring | null
miner_countinteger
pool_countinteger
node_tip_heightinteger | null
indexed_heightinteger | null
index_lag_blocksinteger | null
is_fully_indexedboolean | null

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/summary" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "chain": "qrl",
  "network": "mainnet",
  "difficulty": "4330557182",
  "hash_power": 3821079808,
  "block_time_mean": 59,
  "block_time_sd": 57,
  "block_last_reward_shor": "1315526393",
  "coins_emitted_shor": "79710546216043289",
  "max_supply_qrl": "105000000",
  "emission_pct": 75.91480592004123,
  "stats_updated_at": "2026-07-07T19:28:10",
  "total_blocks": 2224460,
  "last_block_time": "2022-09-11T03:28:50",
  "miner_count": 48,
  "pool_count": 44,
  "node_tip_height": 4236819,
  "indexed_height": 2224459,
  "index_lag_blocks": 2012360,
  "is_fully_indexed": false
}
GET/api/v1/qrl/mining/top-minersQRL (PoW)

Top miners & pools leaderboard

Leaderboard of coinbase addresses by blocks mined, with wallet-class label (miner / miningpool) and reward earned. window=all is all-time.

Query parameters

NameTypeRequiredDefaultDescription
windowstringnoall
limitintegermin 1 · max 200no50

Response 200 · TopMinersList

itemsTopMinerItem[]
addressstringrequired
labelstring | null
wallet_classstring
wallet_class_methodstring | null
blocks_minedinteger
reward_shorstring
sharenumber
last_block_timestring | null
countinteger
windowstring
total_blocksinteger

Request examples

curl -s "https://quantascan.io/api/v1/qrl/mining/top-miners" \
  -H "Authorization: Bearer qs_YOUR_API_KEY"
Example response
{
  "items": [
    {
      "address": "Q010800d1f8900a72abeb583737b8bcd1185e07a54760551173cd15ffe2408048a2df150556cad9",
      "label": "MiningOcean",
      "wallet_class": "miningpool",
      "wallet_class_method": "label",
      "blocks_mined": 214981,
      "reward_shor": "1246992534841572",
      "share": 0.1524801492309711,
      "last_block_time": null
    },
    {
      "address": "Q0106003b59b48dbe83b91b77961d4001407a3973d613d12f06913e52e0e8c7916be4662dc2a33b",
      "label": "",
      "wallet_class": "miningpool",
      "wallet_class_method": "heuristic",
      "blocks_mined": 142388,
      "reward_shor": "813962795486173",
      "share": 0.10099191783785318,
      "last_block_time": null
    },
    "… (48 more)"
  ],
  "count": 50,
  "window": "all",
  "total_blocks": 1409895
}

All endpoints verified against a live indexer. Need the raw spec? See openapi.json or the API overview.