Networks API

The Networks API provides information about supported blockchain networks and gas pricing.

Authentication

All network endpoints require authentication. See Authentication for details.

Get Networks

Get a list of all supported blockchain networks.

Endpoint

GET /networks

Response

[
  {
    "name": "ethereum_mainnet",
    "chainId": 1,
    "providerUrls": [
      "https://eth.gateway.tenderly.co",
      "https://eth-mainnet.g.alchemy.com/v2/..."
    ]
  },
  {
    "name": "sepolia_ethereum",
    "chainId": 11155111,
    "providerUrls": ["https://sepolia.gateway.tenderly.co"]
  }
]

Example

curl https://your-rrelayer.com/networks \
  -u "username:password"

Get Network

Get details for a specific network.

Endpoint

GET /networks/{chain_id}

Response

{
  "name": "sepolia_ethereum",
  "chainId": 11155111,
  "providerUrls": ["https://sepolia.gateway.tenderly.co"]
}

Example

curl https://your-rrelayer.com/networks/11155111 \
  -u "username:password"

Get Gas Price

Get current gas price estimates for a specific network.

Endpoint

GET /networks/gas/price/{chain_id}

Response

{
  "slow": {
    "maxPriorityFee": "0.1",
    "maxFee": "2.5",
    "minWaitTimeEstimate": 180,
    "maxWaitTimeEstimate": 300
  },
  "medium": {
    "maxPriorityFee": "0.5",
    "maxFee": "4.0",
    "minWaitTimeEstimate": 60,
    "maxWaitTimeEstimate": 120
  },
  "fast": {
    "maxPriorityFee": "1.0",
    "maxFee": "6.0",
    "minWaitTimeEstimate": 15,
    "maxWaitTimeEstimate": 60
  },
  "super_fast": {
    "maxPriorityFee": "2.0",
    "maxFee": "10.0",
    "minWaitTimeEstimate": 5,
    "maxWaitTimeEstimate": 15
  }
}

Gas Price Fields

Field	Type	Description
`maxPriorityFee`	`string`	Priority fee in Gwei
`maxFee`	`string`	Maximum fee in Gwei
`minWaitTimeEstimate`	`number`	Minimum wait time in seconds
`maxWaitTimeEstimate`	`number`	Maximum wait time in seconds

Example

curl https://your-rrelayer.com/networks/gas/price/11155111 \
  -u "username:password"

Error Responses

Common Error Codes

Status	Code	Description
400	`INVALID_REQUEST`	Invalid request parameters
401	`UNAUTHORIZED`	Authentication required
404	`NOT_FOUND`	Network not found
500	`INTERNAL_ERROR`	Server error
503	`SERVICE_UNAVAILABLE`	Gas provider unavailable

Gas Price Providers

rrelayer supports multiple gas price providers configured per network in the rrelayer configuration, which you can read more about here

The API returns gas prices from the configured provider for the requested network.