Relayer Overview

The Gelato Relayer provides a standardized set of JSON-RPC methods for submitting gasless transactions. These methods support sponsored transactions and transaction status tracking.

Base URL

https://api.gelato.cloud/rpc

Available Methods

Transaction Submission

Method	Description
`relayer_sendTransaction`	Submit a signed transaction for relay
`relayer_sendTransactionSync`	Submit and wait for transaction confirmation

Fee Estimation

Method	Description
`relayer_getCapabilities`	Get supported payment tokens and fee collector addresses
`relayer_getFeeData`	Get token exchange rates for manual fee calculation
`relayer_getFeeQuote`	Get a fee quote for a specific gas amount

Status Tracking

Method	Description
`relayer_getStatus`	Check status with full transaction receipt

Payment Type

The relayer covers gas fees. Requires a valid API key with sufficient Gas Tank balance.

{
  "payment": {
    "type": "sponsored"
  }
}

Authentication

All requests require an API key passed via the X-API-Key header:

curl -X POST https://api.gelato.cloud/rpc \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ ... }'

Create an API Key at the Gelato App.

Status Codes

Code	Status	Description
`100`	Pending	Transaction received, not yet submitted
`110`	Submitted	Transaction broadcast, awaiting inclusion
`200`	Included	Transaction confirmed on-chain
`400`	Rejected	Transaction rejected by relayer
`500`	Reverted	Transaction reverted on-chain

Error Codes

Code	Message	Description
`-32602`	Invalid params	Missing or malformed parameters
`4100`	Unauthorized	Invalid or missing API key
`4200`	Insufficient Payment	Payment amount too low
`4201`	Invalid Signature	Signature verification failed
`4202`	Unsupported Payment Token	Token not supported
`4204`	Quote Expired	Fee quote has expired
`4205`	Insufficient Balance	User balance too low
`4206`	Unsupported Chain	Chain ID not supported
`4208`	Unknown Transaction ID	Task ID not found
`4211`	Simulation Failed	Transaction simulation failed

Gelato Turbo Relayer

EVM Gasless Features

How-To Guides

Relayer API Endpoints

Additional Resources

Relayer Overview

Base URL

Available Methods

Transaction Submission

Fee Estimation

Status Tracking

Payment Type

Sponsored

Authentication

Status Codes

Error Codes

​Base URL

​Available Methods

​Transaction Submission

​Fee Estimation

​Status Tracking

​Payment Type

​Sponsored

​Authentication

​Status Codes

​Error Codes

Base URL

Available Methods

Transaction Submission

Fee Estimation

Status Tracking

Payment Type

Sponsored

Authentication

Status Codes

Error Codes