Prerequisites Setup

You'll need to get an API key from us to use the service. If you login to the dashboard via the SSO link you should navigate to Access on the bottom lefthand navigation panel and then request a new API key. You can also configure every aspect of the load balancer via Dashboard UI, or purely via API.

Adaptive Load Balancing Procedure

You then use the name of your route table group as a header like the below example.

Procedure Function Routing

To use embedded protocol procedures you only need to add the key value to your payload. In this example, to use the max block procedure for Ethereum, which polls your routing table for the current block number, and then forwards your request to the endpoints returning the highest block number seen and then returns the first successful response.

Curl Example: Procedures

"procedure": "eth_maxBlockAggReduce"


curl --location 'https://iris.zeus.fyi/v1/router' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-BEARER-TOKEN' \
--header 'X-Route-Group: ethereum-mainnet' \
--data '{
    "jsonrpc": "2.0",
    "procedure": "eth_maxBlockAggReduce",
    "method": "eth_getBlockByNumber",
    "params": ["latest", true],
    "id": 1
}'