Skip to main content

eth_capabilities RPC Method

Returns a description of the historical data the node can serve, allowing clients to determine which RPC methods and block ranges a node supports without hitting history-pruned errors.

Updated on
Oct 15, 2026

Parameters

This method does not accept any parameters

Returns

result
object

An object describing the node's current head and the data resources it can serve

head
object

The current canonical head reported by the node

number
string

The head block number in hexadecimal format

hash
string

The head block hash

state
object

Availability of historical state (used by state-reading methods such as eth_getBalance, eth_getCode, and eth_getStorageAt)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

tx
object

Availability of the transaction lookup index (used by methods such as eth_getTransactionByHash and eth_getTransactionReceipt)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

logs
object

Availability of the log search index (used by eth_getLogs)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

receipts
object

Availability of historical receipts (used by methods such as eth_getBlockReceipts and eth_getTransactionReceipt)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

blocks
object

Availability of historical blocks (used by methods such as eth_getBlockByNumber and eth_getBlockByHash)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

stateproofs
object

Availability of historical state proofs (used by eth_getProof)

disabled
boolean

Whether the resource is disabled entirely

oldestBlock
string

The oldest block for which the resource is available, in hexadecimal format

deleteStrategy
object

Describes how data is removed over time. Present only for resources with sliding-window retention

type
string

The deletion strategy type, e.g. window

retentionBlocks
string

The number of most recent blocks retained, in hexadecimal format

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"head": {
6
"number": "0x931b63",
7
"hash": "0x3c441875a50803eaa1e47f59e74028e9dc24d187f741e86225b9659e310b7b87"
8
},
9
"state": {
10
"disabled": false,
11
"oldestBlock": "0x931ae4",
12
"deleteStrategy": {
13
"type": "window",
14
"retentionBlocks": "0x80"
15
}
16
},
17
"tx": {
18
"disabled": false,
19
"oldestBlock": "0x0"
20
},
21
"logs": {
22
"disabled": false,
23
"oldestBlock": "0x0"
24
},
25
"receipts": {
26
"disabled": false,
27
"oldestBlock": "0x0"
28
},
29
"blocks": {
30
"disabled": false,
31
"oldestBlock": "0x0"
32
},
33
"stateproofs": {
34
"disabled": false,
35
"oldestBlock": "0x931ae4",
36
"deleteStrategy": {
37
"type": "window",
38
"retentionBlocks": "0x80"
39
}
40
}
41
}
42
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"head": {
6
"number": "0x931b63",
7
"hash": "0x3c441875a50803eaa1e47f59e74028e9dc24d187f741e86225b9659e310b7b87"
8
},
9
"state": {
10
"disabled": false,
11
"oldestBlock": "0x931ae4",
12
"deleteStrategy": {
13
"type": "window",
14
"retentionBlocks": "0x80"
15
}
16
},
17
"tx": {
18
"disabled": false,
19
"oldestBlock": "0x0"
20
},
21
"logs": {
22
"disabled": false,
23
"oldestBlock": "0x0"
24
},
25
"receipts": {
26
"disabled": false,
27
"oldestBlock": "0x0"
28
},
29
"blocks": {
30
"disabled": false,
31
"oldestBlock": "0x0"
32
},
33
"stateproofs": {
34
"disabled": false,
35
"oldestBlock": "0x931ae4",
36
"deleteStrategy": {
37
"type": "window",
38
"retentionBlocks": "0x80"
39
}
40
}
41
}
42
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free