Skip to content

Commit 4b0a0cb

Browse files
authored
Reorganize rate limit docs (#599)
* reorganize rate limit docs * Fix sidebar * clean up language * cross-link * fix cross-link
1 parent f1b74a6 commit 4b0a0cb

File tree

4 files changed

+36
-15
lines changed

4 files changed

+36
-15
lines changed
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: Rate Limits
3+
---
4+
5+
In order to protect our services from abuse we have rate limits on the number of requests that can be made. Currently, the rate limits are set as follows.
6+
7+
## `relay.flashbots.net` - Bundles
8+
9+
| Method | Limit |
10+
|---------------------|--------------------|
11+
| `eth_sendBundle` | 1800 / IP / 1 min |
12+
| `mev_sendBundle` | 1800 / IP / 1 min |
13+
| `eth_cancelBundle` | 600 / IP / 1 min |
14+
| `mev_simBundle` | 300 / IP / 1 min |
15+
| `eth_callBundle` | 300 / IP / 1 min |
16+
| All others | 120 / IP / 1 min |
17+
18+
Note that this is _requests_ and not _transactions_ submitted per second. There is no limitation on the number of transactions in a request.
19+
20+
RPC rate limits for retail user transactions sent to `rpc.flashbots.net` [can be found here](../../flashbots-protect/ratelimiting).
21+
22+
## Rate limit exceptions
23+
24+
If you require a higher rate limit please reach out to [Shea Ketsdever](https://twitter.com/SheaKetsdever).

docs/flashbots-protect/additional-documentation/ratelimiting.md renamed to docs/flashbots-protect/ratelimiting.mdx

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Rate limiting
2+
title: Rate Limits
33
---
44

55
In order to protect our services from abuse we have rate limits on the number of requests that can be made. Currently, the rate limits are set as follows.
@@ -15,18 +15,9 @@ In order to protect our services from abuse we have rate limits on the number of
1515
| `eth_getBalance` | 200 / IP / 5 min |
1616
| All others | 600 / IP / 5 min |
1717

18-
Note that this is _requests_ and not _transactions_ submitted per second. There is no limitation on the number of transactions in a request. Note that you are not required to read JSON RPC requests to send transactions to Flashbots Protect RPC.
18+
Note that you are not required to read JSON RPC requests to send transactions to Flashbots Protect RPC.
1919

20-
## `relay.flashbots.net` - Bundles
21-
22-
| Method | Limit |
23-
|---------------------|--------------------|
24-
| `eth_sendBundle` | 1800 / IP / 1 min |
25-
| `mev_sendBundle` | 1800 / IP / 1 min |
26-
| `eth_cancelBundle` | 600 / IP / 1 min |
27-
| `mev_simBundle` | 300 / IP / 1 min |
28-
| `eth_callBundle` | 300 / IP / 1 min |
29-
| All others | 120 / IP / 1 min |
20+
Relay rate limits for advanced user bundles sent to `relay.flashbots.net` [can be found here](../flashbots-mev-share/searchers/ratelimiting).
3021

3122
## Rate limiting exceptions
3223

docs/guide-send-tx-bundle.mdx

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,11 @@ Flashbots offers two primary JSON-RPC endpoints on Ethereum Mainnet: `rpc.flashb
1212
- **Purpose**: Designed specifically for retail users as a drop-in RPC replacement in their wallet.
1313
- **Features**: Provides MEV protection and MEV refunds for eligible transactions. Support all the regular [Ethereum JSON RPC methods](https://docs.infura.io/networks/ethereum/json-rpc-methods/) but not [Flashbots specific JSON RPC
1414
methods](flashbots-auction/advanced/rpc-endpoint).
15-
- **Performance**: [Rate limited](/flashbots-protect/additional-documentation/ratelimiting) to satisfy the need of regular users.
1615
- **Note**: Transactions are submitted through `eth_sendRawTransaction` to fit wallet RPC interface. Underneath, the endpoint uses `relay.flashbots.net` to submit transactions.
1716

1817
### `relay.flashbots.net` - For Advanced Users
1918
- **Purpose**: Designed for advanced users, including searchers, applications, and Telegram bots. It accepts both transactions and bundles.
2019
- **Features**: Support all [Flashbots specific JSON RPC methods](flashbots-auction/advanced/rpc-endpoint). Does not support regular [Ethereum JSON RPC methods](https://docs.infura.io/networks/ethereum/json-rpc-methods/).
21-
- **Performance**: Offers a high [rate limit](flashbots-auction/advanced/rpc-endpoint) of 10,000 requests per second per IP address.
2220
- **Recommendation**: Ideal for activities beyond simple transaction submissions via wallets.
2321

2422
## Choosing the Right JSON-RPC Method
@@ -30,3 +28,10 @@ With `relay.flashbots.net` identified as the go-to for advanced operations, the
3028
- **Use**: `mev_sendBundle` for more flexibility and power, like leveraging the [new bundle format](flashbots-mev-share/searchers/understanding-bundles) and [MEV-Share](flashbots-mev-share/introduction).
3129
- **Use**: `eth_sendBundle` if you want something simple and quick! The OG way of sending bundles.
3230
- Both bundle APIs support [multiplexing to multiple builders](flashbots-auction/advanced/multiplexing).
31+
32+
## Rate Limits
33+
34+
In order to protect our services from abuse we have rate limits on the number of requests that can be made.
35+
36+
- [RPC rate limits for retail user transactions sent to](flashbots-protect/ratelimiting) `rpc.flashbots.net`
37+
- [Relay rate limits for advanced user bundles sent to](flashbots-mev-share/searchers/ratelimiting) `relay.flashbots.net`

docs/sidebars.js

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,10 +60,10 @@ module.exports = {
6060
'flashbots-protect/nonce-management',
6161
'flashbots-protect/stuck_transactions',
6262
'flashbots-protect/large-transactions',
63+
'flashbots-protect/ratelimiting',
6364
{
6465
'Additional Documentation': [
6566
'flashbots-protect/additional-documentation/eth-sendPrivateTransaction',
66-
'flashbots-protect/additional-documentation/ratelimiting',
6767
],
6868
}
6969
],
@@ -131,6 +131,7 @@ module.exports = {
131131
'flashbots-mev-share/searchers/understanding-bundles',
132132
'flashbots-mev-share/searchers/sending-bundles',
133133
'flashbots-mev-share/searchers/debugging',
134+
'flashbots-mev-share/searchers/ratelimiting',
134135
{
135136
'Tutorials': [
136137
{

0 commit comments

Comments
 (0)