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

# Get total mining rewards

`GET /v4/data/mining/totalRewards`

/v4/data/mining/totalRewards

**100 credits per API call**

Get total mining rewards (sum of all coinbase outputs) earned by a UTXO address till date.

Supported blockchains:

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

## 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

## Response `200`

OK

- MiningTotalRewardsResponse — Total mining rewards (sum of all coinbase outputs) for an address.
  - `value` number, required — Total reward value in currency units (BTC, LTC, or DOGE).
  - `valueAsString` string, required — String representation of the total reward value.
  - `address` string, required — Miner address.
  - `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)