The Tatum Mining APIs provide developers with direct access to mining reward data and aggregate mining earnings for supported UTXO blockchains.
They help you power mining dashboards, wallet insights, reporting tools, and reward tracking experiences without building custom indexing infrastructure.
Key Benefits of the Mining APIs
- Reward visibility – Retrieve mining reward history for a miner address.
- Aggregate insights – Access total mining rewards earned by an address to date.
- Flexible filtering – Query reward history by block range or time range.
- Simple integration – Build miner dashboards, explorers, and analytics tools with unified APIs.
Mining API Endpoints
The Mining APIs offer two core endpoints for mining reward tracking and analytics.
Choose the method that best fits your application.
Get Mining Rewards
GET /v4/data/mining/rewards
Get mining rewards (coinbase outputs) for a UTXO address.
Returns all coinbase rewards received by the address when it successfully mined blocks. Supports optional block and time filters, plus pagination.
Get Total Mining Rewards
GET /v4/data/mining/totalRewards
Get total mining rewards earned by a UTXO address to date.
Returns the sum of all coinbase outputs received by the address across supported mining activity.
Supported Blockchains
- Bitcoin —
bitcoin-mainnet,bitcoin-testnet - Litecoin —
litecoin-mainnet,litecoin-testnet - Dogecoin —
dogecoin-mainnet,dogecoin-testnet
Use Cases for Developers
- Build mining dashboards with address-level reward history.
- Show total mining rewards earned in wallet and portfolio views.
- Create reporting tools for miner income and historical reward analysis.
- Add mining analytics to blockchain explorers and infrastructure products.
Mining API FAQs
What is the difference between mining rewards and total mining rewards?
The mining rewards endpoint returns detailed coinbase reward history for a miner address, while the total mining rewards endpoint returns the aggregate sum of all mining rewards earned by that address to date.
Which blockchains are supported?
The Mining API supports Bitcoin, Litecoin, and Dogecoin on both mainnet and testnet variants.
Can I filter mining rewards by time or block range?
Yes. The mining rewards endpoint supports block-based filters and time-based filters. Use only one filter type per request, and pagination is supported through page size and offset parameters.
Which endpoint should I use for summary dashboards?
Use Get Total Mining Rewards for summary cards and aggregate reporting, and use Get Mining Rewards when you need detailed historical reward records.