Skip to main content
The Gelato Relayer provides a standardized set of JSON-RPC methods for submitting gasless transactions. These methods support sponsored transactions, token-based fee payments, and transaction status tracking.

​
Base URLs

https://api.gelato.cloud/rpc

​
Available Methods

​
Transaction Submission

MethodDescription
relayer_sendTransactionSubmit a signed transaction for relay
relayer_sendTransactionSyncSubmit and wait for transaction confirmation
relayer_sendTransactionMultichainSubmit transactions to multiple chains

​
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 Types

The relayer covers gas fees. Requires a valid API key with sufficient Gas Tank balance. 
{
  "payment": {
    "type": "sponsored"
  }
}

​
Token

User pays fees in a supported ERC-20 token. The transaction must include a transfer to the fee collector. 
{
  "payment": {
    "type": "token",
    "address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
  }
}
When using token payments, you must first call relayer_getCapabilities to get the fee collector address and either relayer_getFeeQuote (recommended) or relayer_getFeeData to get the fee amount. These methods are not required for sponsored transactions.

​
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