v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Mining API

Get 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.

get/v4/data/mining/rewards

Query parameters

UTXO chains supported for mining rewards (coinbase).

Example:bitcoin-mainnet

The blockchain to work with.

addressstring required

Example:bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38

The miner blockchain address.

blockFrominteger

Example:900000

Start block number (inclusive). Use with blockTo for block range.

blockTointeger

Example:901000

End block number (inclusive). Use with blockFrom for block range.

unixFrominteger

Start unix timestamp (seconds). Use with unixTo for time range.

unixTointeger

End unix timestamp (seconds). Use with unixFrom for time range.

timeFromstring date-time

Start time (ISO 8601). Use with timeTo for time range.

timeTostring date-time

End time (ISO 8601). Use with timeFrom for time range.

pageSizeinteger required

Number of items to return per page (required, max 500).

offsetinteger

The offset to obtain next page of the data.

Response

blockNumbernumber required

Block number when the reward was mined.

txHashstring required

Transaction hash of the coinbase transaction.

indexnumber required

Output index (vout) in the transaction.

valuenumber required

Reward value in currency units (BTC, LTC, or DOGE).

valueAsStringstring required

String representation of the reward value.

addressstring required

Miner address that received the reward.

UTXO chains supported for mining rewards (coinbase).

Example response

[
  {
    "blockNumber": 900000,
    "txHash": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
    "value": 6.25,
    "valueAsString": "6.25",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "chain": "bitcoin-mainnet"
  }
]