Skip to main content
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

MethodDescription
relayer_sendTransactionSubmit a signed transaction for relay
relayer_sendTransactionSyncSubmit and wait for transaction confirmation

​
Fee Estimation

MethodDescription
relayer_getCapabilitiesGet supported payment tokens and fee collector addresses
relayer_getFeeDataGet token exchange rates for manual fee calculation
relayer_getFeeQuoteGet a fee quote for a specific gas amount

​
Status Tracking

MethodDescription
relayer_getStatusCheck 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

CodeStatusDescription
100PendingTransaction received, not yet submitted
110SubmittedTransaction broadcast, awaiting inclusion
200IncludedTransaction confirmed on-chain
400RejectedTransaction rejected by relayer
500RevertedTransaction reverted on-chain

​
Error Codes

CodeMessageDescription
-32602Invalid paramsMissing or malformed parameters
4100UnauthorizedInvalid or missing API key
4200Insufficient PaymentPayment amount too low
4201Invalid SignatureSignature verification failed
4202Unsupported Payment TokenToken not supported
4204Quote ExpiredFee quote has expired
4205Insufficient BalanceUser balance too low
4206Unsupported ChainChain ID not supported
4208Unknown Transaction IDTask ID not found
4211Simulation FailedTransaction simulation failed