get_coinbase_tx_sum - Monero

Example code for the get_coinbase_tx_sum JSON-RPC method. Complete guide on how to use get_coinbase_tx_sum JSON-RPC in GetBlock Web3 documentation.

This method returns the sum of coinbase transactions (block rewards) over a specified range of blocks. Useful for emission tracking and economic analysis.

Parameters

Parameter

Type

Required

Description

height

unsigned int

Yes

Starting block height for the sum

count

unsigned int

Yes

Number of blocks to include in the sum

Request Example

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "get_coinbase_tx_sum",
    "params": {
        "height": 1563078,
        "count": 2
    },
    "id": "getblock.io"
}'

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "get_coinbase_tx_sum",
    "params": {
        "height": 1563078,
        "count": 2
    },
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let payload = json!({
        "jsonrpc": "2.0",
        "method": "get_coinbase_tx_sum",
        "params": {
                "height": 1563078,
                "count": 2
        },
        "id": "getblock.io"
});

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);

    Ok(())
}

Response Example

{
    "id": "getblock.io",
    "jsonrpc": "2.0",
    "result": {
        "emission_amount": 9387867431838,
        "emission_amount_top64": 0,
        "fee_amount": 83981287,
        "fee_amount_top64": 0,
        "status": "OK",
        "untrusted": false,
        "wide_emission_amount": "0x88981f9080e",
        "wide_fee_amount": "0x501b727"
    }
}

Response Parameters

Field

Type

Description

result.emission_amount

unsigned int

Cumulative coinbase emission over the range (atomic units)

result.fee_amount

unsigned int

Cumulative transaction fees over the range (atomic units)

result.wide_emission_amount

string

128-bit emission amount as hex (for ranges that overflow uint64)

result.wide_fee_amount

string

128-bit fee amount as hex

Use Cases

Tracking XMR emission over time
Economic and supply analytics
Tail-emission auditing post the main supply schedule

Error Handling

Status Code

Error Message

Cause

404

Not Found

Missing or invalid <ACCESS-TOKEN>

-32602

Invalid params

Request parameters are missing or malformed

429

Too Many Requests

Rate limit exceeded for your plan

SDK Integration

import monerojs from 'monero-javascript';

const daemon = await monerojs.connectToDaemonRpc('https://go.getblock.io/<ACCESS-TOKEN>/');

// Most methods are exposed directly on the daemon client. For raw access:
const result = await daemon.getDaemonConnection().sendJsonRequest('get_coinbase_tx_sum', {"height": 1563078, "count": 2});
console.log(result);

from monero.backends.jsonrpc import JSONRPCDaemon
from monero.daemon import Daemon

backend = JSONRPCDaemon(host='go.getblock.io', port=443, path='/<ACCESS-TOKEN>/', protocol='https')
daemon = Daemon(backend)

# For methods covered by the typed API, use the daemon attribute directly.
# For raw RPC access:
result = backend.raw_request('get_coinbase_tx_sum', {"height": 1563078, "count": 2})
print(result)

Previousget_block - Monero Nextget_connections - Monero

Last updated 11 days ago

Was this helpful?