Query Parameters

start_time

integer

Start time as a unix timestamp

end_time

integer

End time as a unix timestamp

Returns

data

object

Contains usage data grouped by tag

tags

array

An array of usage data objects, one per tag

tag_id

integer

The unique identifier of the tag

label

string

The label/name of the tag

credits_used

integer

The total number of credits used by endpoints with this tag (RPC credits and data credits combined)

rpc_credits

integer

The portion of credits_used consumed by RPC requests

data_credits

integer

The portion of credits_used consumed by data usage, such as Streams and Yellowstone gRPC bytes transferred

requests

integer

The total number of requests made by endpoints with this tag

bytes

integer

The total number of data bytes transferred by endpoints with this tag (for example, Streams and Yellowstone gRPC data). Contributes to data_credits

start_time

integer

The start time of the usage period as a unix timestamp

end_time

integer

The end time of the usage period as a unix timestamp

error

string

Contains error details if the request failed; null if successful

Request

1
curl -X 'GET' \
2
  'https://api.quicknode.com/v0/usage/rpc/by-tag' \
3
  -H 'accept: application/json' \
4
  -H 'x-api-key: YOUR_API_KEY'
5

1
curl -X 'GET' \
2
  'https://api.quicknode.com/v0/usage/rpc/by-tag' \
3
  -H 'accept: application/json' \
4
  -H 'x-api-key: YOUR_API_KEY'
5

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3
myHeaders.append("x-api-key", "YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.quicknode.com/v0/usage/rpc/by-tag", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));
15

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3
myHeaders.append("x-api-key", "YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.quicknode.com/v0/usage/rpc/by-tag", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));
15

1
import requests
2

3
url = "https://api.quicknode.com/v0/usage/rpc/by-tag"
4

5
headers = {
6
  'accept': 'application/json',
7
  'x-api-key': 'YOUR_API_KEY',
8
}
9

10
response = requests.request("GET", url, headers=headers)
11

12
print(response.text)
13

1
import requests
2

3
url = "https://api.quicknode.com/v0/usage/rpc/by-tag"
4

5
headers = {
6
  'accept': 'application/json',
7
  'x-api-key': 'YOUR_API_KEY',
8
}
9

10
response = requests.request("GET", url, headers=headers)
11

12
print(response.text)
13

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

4
url = URI("https://api.quicknode.com/v0/usage/rpc/by-tag")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10
request["accept"] = "application/json"
11
request["x-api-key"] = "YOUR_API_KEY"
12

13
response = https.request(request)
14
puts response.read_body
15

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

4
url = URI("https://api.quicknode.com/v0/usage/rpc/by-tag")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10
request["accept"] = "application/json"
11
request["x-api-key"] = "YOUR_API_KEY"
12

13
response = https.request(request)
14
puts response.read_body
15

1
qn usage by-tag --from 7d --to now -o json

1
qn usage by-tag --from 7d --to now -o json

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.admin.getUsageByTag()
6
console.log(response)
7

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.admin.getUsageByTag()
6
console.log(response)
7

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.admin.get_usage_by_tag()
8
    print(response)
9

10

11
asyncio.run(main())
12

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.admin.get_usage_by_tag()
8
    print(response)
9

10

11
asyncio.run(main())
12

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.admin.get_usage_by_tag
6
puts response
7

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.admin.get_usage_by_tag
6
puts response
7

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.admin.get_usage_by_tag(&Default::default()).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.admin.get_usage_by_tag(&Default::default()).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free