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, 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.

successful_requests

integer

Number of successful requests.

bytes

integer

Number of bytes transferred.

request_credits

integer

Credits consumed by requests.

bytes_credits

integer

Credits consumed by transferred bytes.

credits

integer

Total API credits consumed.

active_methods

integer

Number of distinct active methods.

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.

successful_requests

integer

Number of successful requests.

bytes

integer

Number of bytes transferred.

request_credits

integer

Credits consumed by requests.

bytes_credits

integer

Credits consumed by transferred bytes.

credits

integer

Total API credits consumed.

active_methods

integer

Number of distinct active methods.

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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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/metrics/traffic/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
      "successful_requests": 3844107722,
7
      "bytes": 9183226865262,
8
      "request_credits": 1503970715,
9
      "bytes_credits": 137747230,
10
      "credits": 1641717945,
11
      "active_methods": 165
12
    },
13
    "breakdown": [
14
      {
15
        "method": "eth_getblockbynumber",
16
        "successful_requests": 228417835,
17
        "bytes": 0,
18
        "request_credits": 457449606,
19
        "bytes_credits": 0,
20
        "credits": 457449606,
21
        "active_methods": 1
22
      },
23
      {
24
        "method": "eth_getblockreceipts",
25
        "successful_requests": 3552024,
26
        "bytes": 0,
27
        "request_credits": 209569416,
28
        "bytes_credits": 0,
29
        "credits": 209569416,
30
        "active_methods": 1
31
      }
32
    ],
33
    "next_cursor": "REDACTED_CURSOR"
34
  },
35
  "error": null
36
}

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free