Searchers
Stream the Inertia orderflow and bid tips to place your bundle directly behind a transaction.
The searcher API is in early alpha. The API, its limits and the auction rules can change.
Inertia streams the transactions and bundles that pass through its network on their way to the validators. You subscribe to the accounts you care about, and you bid tips to place your own transactions directly behind a streamed transaction.
How it works
- You open a bid stream with
SubmitBundles. - You subscribe to up to 1,024 accounts with
SubscribeOrderflow. - Inertia streams every transaction and bundle that touches one of your accounts, and holds it for 50 ms.
- You bid on it with your own transactions and a tip.
- When the 50 ms are over, the highest tip wins. Inertia sends the streamed transactions and the winning bid to the validator as one bundle.
Access
Every call needs an API key. Ask for one on Telegram or Discord.
Inertia grants two permissions per key:
| Permission | Call |
|---|---|
orderflow | SubscribeOrderflow |
intake | SubmitBundles |
You need both to bid. When Inertia revokes a permission, your open streams close within 30 seconds.
Connect
The API is gRPC over HTTP/2 without TLS, on port 11227. The service is Searcher in the package inertia.searcher.v1. Send your API key in the x-api-key metadata of every call.
| Region | Endpoint |
|---|---|
| Amsterdam | 84.32.103.226:11227 |
More regions are coming. Each node streams only the orderflow that passes through it. Connect to every region your key works on, and send each bid to the node that streamed the bundle.
| Status | Cause |
|---|---|
UNAUTHENTICATED | The x-api-key metadata is missing, or the key is unknown. |
PERMISSION_DENIED | The key lacks the permission for this call. |