Path Parameters

id

string

REQUIRED

The unique identifier for the specific endpoint

Body Parameters

interval

string

REQUIRED

Specifies the time interval for the rate limit; valid values include second, minute or hour

methods

array

REQUIRED

An array of method names to which the rate limiter applies

rate

integer

REQUIRED

Specifies the maximum number of requests allowed for the specified methods within the defined interval

limit_by_ip

boolean

Set to true to apply the rate separately to each client IP. Set to false or omit this field to apply the rate to the endpoint as a whole (the existing behavior).

Returns

data

object

The data object which contains the following fields:

id

string

A unique identifier for the rate limiter

interval

string

The time interval for the rate limit

methods

array

A list of methods the rate limiter applies to

limit_by_ip

boolean

Whether the rate limit applies separately to each client IP (true) or to the endpoint as a whole (false)

rate

integer

The maximum number of requests allowed within the specified interval

status

string

The current status of the rate limiter

created

string

The timestamp when the rate limiter was created in second

error

string

A field containing an error message if any issue occurs

Request

1
curl -X 'POST' \
2
  'https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits' \
3
  -H 'accept: application/json' \
4
  -H 'x-api-key: YOUR_API_KEY' \
5
  -H 'Content-Type: application/json' \
6
  -d '{
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": true
13
}'

1
curl -X 'POST' \
2
  'https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits' \
3
  -H 'accept: application/json' \
4
  -H 'x-api-key: YOUR_API_KEY' \
5
  -H 'Content-Type: application/json' \
6
  -d '{
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": true
13
}'

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

6
const raw = JSON.stringify({
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": true
13
});
14

15
const requestOptions = {
16
  method: "POST",
17
  headers: myHeaders,
18
  body: raw,
19
  redirect: "follow"
20
};
21

22
fetch("https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits", requestOptions)
23
  .then((response) => response.text())
24
  .then((result) => console.log(result))
25
  .catch((error) => console.error(error));

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

6
const raw = JSON.stringify({
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": true
13
});
14

15
const requestOptions = {
16
  method: "POST",
17
  headers: myHeaders,
18
  body: raw,
19
  redirect: "follow"
20
};
21

22
fetch("https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits", requestOptions)
23
  .then((response) => response.text())
24
  .then((result) => console.log(result))
25
  .catch((error) => console.error(error));

1
import requests
2
import json
3

4
url = "https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits"
5

6
payload = json.dumps({
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": True
13
})
14
headers = {
15
  'accept': 'application/json',
16
  'x-api-key': 'YOUR_API_KEY',
17
  'Content-Type': 'application/json',
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)
23

1
import requests
2
import json
3

4
url = "https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits"
5

6
payload = json.dumps({
7
  "interval": "second",
8
  "methods": [
9
    "eth_getLogs"
10
  ],
11
  "rate": 10,
12
  "limit_by_ip": True
13
})
14
headers = {
15
  'accept': 'application/json',
16
  'x-api-key': 'YOUR_API_KEY',
17
  'Content-Type': 'application/json',
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)
23

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

5
url = URI("https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits")
6

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

10
request = Net::HTTP::Post.new(url)
11
request["accept"] = "application/json"
12
request["x-api-key"] = "YOUR_API_KEY"
13
request["Content-Type"] = "application/json"
14
request.body = JSON.dump({
15
  "interval": "second",
16
  "methods": [
17
    "eth_getLogs"
18
  ],
19
  "rate": 10,
20
  "limit_by_ip": true
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

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

5
url = URI("https://api.quicknode.com/v0/endpoints/{id}/method-rate-limits")
6

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

10
request = Net::HTTP::Post.new(url)
11
request["accept"] = "application/json"
12
request["x-api-key"] = "YOUR_API_KEY"
13
request["Content-Type"] = "application/json"
14
request.body = JSON.dump({
15
  "interval": "second",
16
  "methods": [
17
    "eth_getLogs"
18
  ],
19
  "rate": 10,
20
  "limit_by_ip": true
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

1
qn endpoint rate-limit method-create {endpoint_id} \
2
      --method eth_call \
3
      --interval second \
4
      --rate 25 \
5
      -o json

1
qn endpoint rate-limit method-create {endpoint_id} \
2
      --method eth_call \
3
      --interval second \
4
      --rate 25 \
5
      -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.createMethodRateLimit("ENDPOINT_ID", { interval: "second", methods: ["eth_blockNumber"], rate: 100 })
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.createMethodRateLimit("ENDPOINT_ID", { interval: "second", methods: ["eth_blockNumber"], rate: 100 })
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.create_method_rate_limit("ENDPOINT_ID", interval="second", methods=["eth_blockNumber"], rate=100)
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.create_method_rate_limit("ENDPOINT_ID", interval="second", methods=["eth_blockNumber"], rate=100)
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.create_method_rate_limit("ENDPOINT_ID", interval: "second", methods: ["eth_blockNumber"], rate: 100)
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.create_method_rate_limit("ENDPOINT_ID", interval: "second", methods: ["eth_blockNumber"], rate: 100)
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.create_method_rate_limit("ENDPOINT_ID", &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.create_method_rate_limit("ENDPOINT_ID", &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