Skip to main content

getmemoryinfo RPC Method

Returns an object that contains information regarding memory usage.

Updated on
Feb 03, 2026

Parameters

mode
string

It determines what kind of information is returned. "stats" returns general statistics about memory usage in the daemon and "mallocinfo" returns an XML string describing low-level heap state (only available if compiled with glibc 2.10+)

Returns

result
object

Memory usage information for the node

locked
object

Information about locked memory manager

used
integer

Number of bytes used

free
integer

Number of bytes available in current arenas

total
integer

Total number of bytes managed

locked
integer

Amount of bytes that succeeded locking. If this number is smaller than total, locking pages failed at some point and key data could be swapped to disk

chunks_used
integer

Number allocated chunks

chunks_free
integer

Number of unused chunks

error
object | null

(Optional) JSON-RPC error when the request failed; omitted or null on success

code
integer

Error code

message
string

Error message

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"result": {
4
"locked": {
5
"used": 1760,
6
"free": 260384,
7
"total": 262144,
8
"locked": 262144,
9
"chunks_used": 45,
10
"chunks_free": 4
11
}
12
},
13
"id": 1
14
}
1
{
2
"jsonrpc": "2.0",
3
"result": {
4
"locked": {
5
"used": 1760,
6
"free": 260384,
7
"total": 262144,
8
"locked": 262144,
9
"chunks_used": 45,
10
"chunks_free": 4
11
}
12
},
13
"id": 1
14
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free