queryLedgerState_treasuryAndReserves - Cardano

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

This method returns the current balances of the treasury and reserves ada pots, which fund rewards and governance actions.

Parameters

This method does not require parameters.

Request

cURL

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

JavaScript

example.js

const response = await fetch(
    'https://go.getblock.io/<ACCESS-TOKEN>/',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({"jsonrpc": "2.0", "method": "queryLedgerState/treasuryAndReserves", "id": "getblock.io"})
    }
);
console.log(await response.json());

Python

example.py

import requests

response = requests.post(
    'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers={'Content-Type': 'application/json'},
    json={"jsonrpc": "2.0", "method": "queryLedgerState/treasuryAndReserves", "id": "getblock.io"}
)

print(response.json())

Response

{
    "jsonrpc": "2.0",
    "method": "queryLedgerState/treasuryAndReserves",
    "result": {
        "treasury": {
            "ada": {
                "lovelace": 1444502385502327
            }
        },
        "reserves": {
            "ada": {
                "lovelace": 6216188192911211
            }
        }
    },
    "id": "getblock.io"
}

Response Parameters

Field	Type	Description
treasury	object	Current treasury balance in lovelace
reserves	object	Current reserves balance in lovelace

Use Cases

• Monetary Analysis: Track treasury and reserves over time

• Governance Modeling: Estimate funds available for governance actions

• Dashboards: Display protocol pot balances

• Issuance Studies: Model reward funding from reserves

Error Handling

Error Code	Message	Description
-32602	Invalid params	A required field is missing or has the wrong type
-32000	Query unavailable	The query is not available in the current ledger era
-32603	Internal error	The node failed to answer the query