---
title: "Get mining rewards"
method: GET
path: "/v4/data/mining/rewards"
tags: ["Mining API"]
---

# Get mining rewards

`GET /v4/data/mining/rewards`

/v4/data/mining/rewards

**50 credits per API call**

Get mining rewards (coinbase outputs) for a UTXO address. This endpoint returns all coinbase rewards received by the address when it successfully mined blocks.

Supported blockchains:

*   Bitcoin - bitcoin-mainnet / bitcoin-testnet
*   Litecoin - litecoin-mainnet / litecoin-testnet
*   Dogecoin - dogecoin-mainnet / dogecoin-testnet

To get started:

*   Provide a chain and miner address. The API will return all coinbase rewards for the address.
*   Omit filters for full history, or use one filter type: (blockFrom and/or blockTo), (timeFrom and/or timeTo), or (unixFrom and/or unixTo). You cannot mix filter types.
*   You can use from-only (e.g. blockFrom) or to-only (e.g. blockTo) or both.
*   Rewards are sorted by block number in descending order (newest first).
*   Pagination is supported via `pageSize` (max 500) and `offset` parameters.

## Query parameters

- `chain` 'bitcoin-mainnet' | 'bitcoin-testnet' | 'litecoin-mainnet' | 'litecoin-testnet' | 'doge-mainnet' | 'dogecoin-testnet', required — UTXO chains supported for mining rewards (coinbase).
- `address` string, required
- `blockFrom` integer
- `blockTo` integer
- `unixFrom` integer
- `unixTo` integer
- `timeFrom` string, date-time
- `timeTo` string, date-time
- `pageSize` integer, required
- `offset` integer

## Response `200`

OK

- MiningRewardEntry[]
  - `blockNumber` number, required — Block number when the reward was mined.
  - `txHash` string, required — Transaction hash of the coinbase transaction.
  - `index` number, required — Output index (vout) in the transaction.
  - `value` number, required — Reward value in currency units (BTC, LTC, or DOGE).
  - `valueAsString` string, required — String representation of the reward value.
  - `address` string, required — Miner address that received the reward.
  - `chain` 'bitcoin-mainnet' | 'bitcoin-testnet' | 'litecoin-mainnet' | 'litecoin-testnet' | 'doge-mainnet' | 'dogecoin-testnet', required — UTXO chains supported for mining rewards (coinbase).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403` — Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500` — Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)