This method is available only to Enterprise accounts. See the Observability overview for more information.

Query Parameters

from

string

ISO 8601 start time. Required together with to when last is omitted.

to

string

ISO 8601 end time. Required together with from when last is omitted.

last

string

Relative time window instead of from and to; for example, 1h for the last hour.

group_by[]

array

Repeat this query parameter for grouping dimensions: method, network, endpoint. Omit it to return totals without a breakdown.

limit

integer

Positive maximum number of results per page; for example, 2.

cursor

string

Opaque next_cursor from the previous response. Keep the same time range, filters, grouping, and limit when requesting subsequent pages.

Returns

data

object | null

Response data. Null when the request fails.

from

string

Effective start of the returned time range, in ISO 8601 format.

to

string

Effective end of the returned time range, in ISO 8601 format.

totals

object

Aggregate totals for the selected time range.

requests

integer

Number of RPC requests.

bytes

integer

Number of bytes transferred.

rpc_credits

integer

Credits consumed by RPC requests.

data_credits

integer

Credits consumed by data transfer.

credits

integer

Total API credits consumed.

breakdown

array

Grouped results. Present when grouping is requested; can be empty.

method

string

RPC method name. In a breakdown, present when grouping by method.

requests

integer

Number of RPC requests.

bytes

integer

Number of bytes transferred.

rpc_credits

integer

Credits consumed by RPC requests.

data_credits

integer

Credits consumed by data transfer.

credits

integer

Total API credits consumed.

network

string

Present when grouping by network.

endpoint

string

Endpoint UUID; present when grouping by endpoint.

next_cursor

string

Opaque continuation cursor. Present when another page is available. Pass it unchanged as cursor.

error

string | null

Error message on failure; null on success.

Request

1
curl --get "https://api.quicknode.com/v0/usage/rpc/summary" \
2
  --header "accept: application/json" \
3
  --header "x-api-key: ${QN_API_KEY}" \
4
  --data-urlencode 'from=2026-10-19T19:29:00Z' \
5
  --data-urlencode 'to=2026-10-20T19:29:00Z' \
6
  --data-urlencode 'group_by[]=method' \
7
  --data-urlencode 'limit=2'
8

1
curl --get "https://api.quicknode.com/v0/usage/rpc/summary" \
2
  --header "accept: application/json" \
3
  --header "x-api-key: ${QN_API_KEY}" \
4
  --data-urlencode 'from=2026-10-19T19:29:00Z' \
5
  --data-urlencode 'to=2026-10-20T19:29:00Z' \
6
  --data-urlencode 'group_by[]=method' \
7
  --data-urlencode 'limit=2'
8

1
const url = new URL(`https://api.quicknode.com/v0/usage/rpc/summary`);
2
url.searchParams.append("from", "2026-10-19T19:29:00Z");
3
url.searchParams.append("to", "2026-10-20T19:29:00Z");
4
url.searchParams.append("group_by[]", "method");
5
url.searchParams.append("limit", "2");
6

7
fetch(url, {
8
  headers: { "accept": "application/json", "x-api-key": process.env.QN_API_KEY },
9
})
10
  .then(async (response) => {
11
    const body = await response.text();
12
    if (!response.ok) throw new Error(`HTTP ${response.status}: ${body}`);
13
    console.log(body);
14
  })
15
  .catch((error) => { console.error(error); process.exitCode = 1; });
16

1
const url = new URL(`https://api.quicknode.com/v0/usage/rpc/summary`);
2
url.searchParams.append("from", "2026-10-19T19:29:00Z");
3
url.searchParams.append("to", "2026-10-20T19:29:00Z");
4
url.searchParams.append("group_by[]", "method");
5
url.searchParams.append("limit", "2");
6

7
fetch(url, {
8
  headers: { "accept": "application/json", "x-api-key": process.env.QN_API_KEY },
9
})
10
  .then(async (response) => {
11
    const body = await response.text();
12
    if (!response.ok) throw new Error(`HTTP ${response.status}: ${body}`);
13
    console.log(body);
14
  })
15
  .catch((error) => { console.error(error); process.exitCode = 1; });
16

1
import os
2
from urllib.parse import quote
3
import requests
4

5
url = f"https://api.quicknode.com/v0/usage/rpc/summary"
6
params = {'from': '2026-10-19T19:29:00Z', 'to': '2026-10-20T19:29:00Z', 'group_by[]': 'method', 'limit': 2}
7
response = requests.get(
8
    url, params=params,
9
    headers={"accept": "application/json", "x-api-key": os.environ["QN_API_KEY"]},
10
    timeout=60,
11
)
12
response.raise_for_status()
13
print(response.text)
14

1
import os
2
from urllib.parse import quote
3
import requests
4

5
url = f"https://api.quicknode.com/v0/usage/rpc/summary"
6
params = {'from': '2026-10-19T19:29:00Z', 'to': '2026-10-20T19:29:00Z', 'group_by[]': 'method', 'limit': 2}
7
response = requests.get(
8
    url, params=params,
9
    headers={"accept": "application/json", "x-api-key": os.environ["QN_API_KEY"]},
10
    timeout=60,
11
)
12
response.raise_for_status()
13
print(response.text)
14

1
require "uri"
2
require "net/http"
3

4
url = URI("https://api.quicknode.com/v0/usage/rpc/summary")
5
url.query = URI.encode_www_form({"from" => "2026-10-19T19:29:00Z", "to" => "2026-10-20T19:29:00Z", "group_by[]" => "method", "limit" => "2"})
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8
request["x-api-key"] = ENV.fetch("QN_API_KEY")
9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: true) { |http| http.request(request) }
10
raise "HTTP #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
11
puts response.body
12

1
require "uri"
2
require "net/http"
3

4
url = URI("https://api.quicknode.com/v0/usage/rpc/summary")
5
url.query = URI.encode_www_form({"from" => "2026-10-19T19:29:00Z", "to" => "2026-10-20T19:29:00Z", "group_by[]" => "method", "limit" => "2"})
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8
request["x-api-key"] = ENV.fetch("QN_API_KEY")
9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: true) { |http| http.request(request) }
10
raise "HTTP #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
11
puts response.body
12

Response

1
{
2
  "data": {
3
    "from": "2026-10-19T19:00:00.000000Z",
4
    "to": "2026-10-20T20:00:00.000000Z",
5
    "totals": {
6
      "requests": 3844107722,
7
      "bytes": 9183226865262,
8
      "rpc_credits": 1503970715,
9
      "data_credits": 137747230,
10
      "credits": 1641717945
11
    },
12
    "breakdown": [
13
      {
14
        "method": "eth_getblockbynumber",
15
        "requests": 228417835,
16
        "bytes": 0,
17
        "rpc_credits": 457449606,
18
        "data_credits": 0,
19
        "credits": 457449606
20
      },
21
      {
22
        "method": "eth_getblockreceipts",
23
        "requests": 3552024,
24
        "bytes": 0,
25
        "rpc_credits": 209569416,
26
        "data_credits": 0,
27
        "credits": 209569416
28
      }
29
    ],
30
    "next_cursor": "REDACTED_CURSOR"
31
  },
32
  "error": null
33
}

1
{
2
  "data": {
3
    "from": "2026-10-19T19:00:00.000000Z",
4
    "to": "2026-10-20T20:00:00.000000Z",
5
    "totals": {
6
      "requests": 3844107722,
7
      "bytes": 9183226865262,
8
      "rpc_credits": 1503970715,
9
      "data_credits": 137747230,
10
      "credits": 1641717945
11
    },
12
    "breakdown": [
13
      {
14
        "method": "eth_getblockbynumber",
15
        "requests": 228417835,
16
        "bytes": 0,
17
        "rpc_credits": 457449606,
18
        "data_credits": 0,
19
        "credits": 457449606
20
      },
21
      {
22
        "method": "eth_getblockreceipts",
23
        "requests": 3552024,
24
        "bytes": 0,
25
        "rpc_credits": 209569416,
26
        "data_credits": 0,
27
        "credits": 209569416
28
      }
29
    ],
30
    "next_cursor": "REDACTED_CURSOR"
31
  },
32
  "error": null
33
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free