Linea · Rate Limits

Linea Rate Limits

Linea exposes three distinct API surfaces with independent rate limits. The public JSON-RPC endpoint (rpc.linea.build) is free but rate-limited per IP; exact limits are not published and vary with network load — production traffic should use private node providers (Infura, Alchemy). The Token REST API enforces a hard cap of 2 requests per second and 60 requests per minute per IP address. The Lineascan explorer API follows Etherscan V2 tier limits ranging from 3 calls/second on the Free tier up to 30 calls/second on Professional and unmetered on Enterprise. Throttled responses return HTTP 429.

Linea Rate Limits is the machine-readable rate-limit profile for Linea on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 10 rate-limit definitions, measuring requests_per_second, requests_per_minute, and requests_per_day.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Blockchain, Layer 2, Ethereum, ZK-EVM, and Rate Limiting.

10 Limits Throttle: 429
BlockchainLayer 2EthereumZK-EVMRate Limiting

Limits

Public RPC endpoint ip_address
requests_per_second
-1
rpc.linea.build is rate-limited per IP but exact thresholds are not publicly documented. Free and suitable for development; use Infura, Alchemy, or QuickNode for production.
Token API - per second ip_address
requests_per_second
2
Hard cap of 2 requests per second per IP address on the Token REST API.
Token API - per minute ip_address
requests_per_minute
60
Hard cap of 60 requests per minute per IP address on the Token REST API.
Lineascan Explorer API - Free tier api_key
requests_per_second
3
Community chain free tier; 100,000 calls/day maximum.
Lineascan Explorer API - Free tier daily api_key
requests_per_day
100000
Daily call quota for the Free tier of the Etherscan V2 API.
Lineascan Explorer API - Lite tier api_key
requests_per_second
5
$49/month; 100,000 calls/day; all supported chains.
Lineascan Explorer API - Standard tier api_key
requests_per_second
10
$199/month; 200,000 calls/day; includes API Pro endpoints.
Lineascan Explorer API - Advanced tier api_key
requests_per_second
20
$299/month; 500,000 calls/day.
Lineascan Explorer API - Professional tier api_key
requests_per_second
30
$399/month; 1,000,000 calls/day.
Lineascan Explorer API - Enterprise tier api_key
requests_per_second
-1
Custom pricing; unmetered rate limits with dedicated infrastructure and SLA.

Policies

Exponential Backoff
On HTTP 429 responses, apply exponential backoff with jitter before retrying. The Token API documentation explicitly recommends this pattern.
Caching
Cache token metadata and price responses locally to reduce Token API call volume; price data updates on a cadence that does not require per-request freshness.
Pagination
Use page and limit parameters on Token API list endpoints; use the Lineascan API cursor or offset parameters for large result sets rather than tightening page size and re-polling.
Private RPC for Production
The public rpc.linea.build endpoint is unsuitable for production traffic due to undocumented rate limits and no SLA. Register with Infura, Alchemy, QuickNode, Chainstack, or Dwellir for a private endpoint with guaranteed throughput.
API Key Per Workload
Obtain separate Lineascan API keys per application workload to isolate quota consumption and enable per-service cost attribution.

Sources