getmemoryinfo - Bitcoin

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

This method returns information about memory usage by the node.

Parameters

Parameter	Type	Required	Description
mode	string	No	"stats" for general statistics, "mallocinfo" for detailed malloc info (default: "stats").

Request

cURL

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

Axios

Request

Rust

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "locked": {
            "used": 32768,
            "free": 229376,
            "total": 262144,
            "locked": 262144,
            "chunks_used": 2,
            "chunks_free": 1
        }
    }
}

Response Parameters

Field	Type	Description
locked	object	Information about locked memory manager.
locked.used	number	Number of bytes used.
locked.free	number	Number of bytes available in current arenas.
locked.total	number	Total number of bytes managed.
locked.locked	number	Amount of bytes currently locked.
locked.chunks_used	number	Number of allocated chunks.
locked.chunks_free	number	Number of unused chunks.

Use Case

The getmemoryinfo method is essential for:

• Monitoring node memory usage

• Diagnosing memory-related issues

• Performance optimization analysis

• Building node health dashboards

• Capacity planning

• Debugging memory leaks

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN.
-8	Invalid mode	The specified mode is not valid.

Integration With Web3

The getmemoryinfo method helps developers:

• Monitor node resource usage

• Build operational dashboards

• Diagnose performance issues

• Track memory allocation patterns

• Support node maintenance workflows