TheRPCを始める

選択されたチェーン

Ethereum

はじめに

APIリファレンス

イーサリアムAPI

Core API

Trace API

Debug API

ガイド

基本操作

ガイド

SDKとツール

よくある質問

Ethereum/レート制限とクォータ

Rate Limits & Quotas

This guide explains TheRPC's rate limiting system and provides best practices for managing your API usage.

# Request Limits

Rate limits are applied at several levels:

Requests per second
Requests per minute
Requests per day
Concurrent connections

Specific limits depend on your subscription plan. Check your dashboard for current limits.

# Error Responses

When you exceed rate limits, you'll receive:

{
	"jsonrpc": "2.0",
	"error": {
		"code": -32029,
		"message": "Rate limit exceeded"
	},
	"id": 1
}

HTTP response will include headers:

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1628696400

# Best Practices

Implement Retries

async function callWithRetry(method, params, maxRetries = 3) {
	for (let i = 0; i < maxRetries; i++) {
		try {
			const response = await makeRequest(method, params);
			return response;
		} catch (error) {
			if (error.code === -32029) {
				// Rate limit exceeded
				const backoffTime = Math.pow(2, i) * 1000;
				await new Promise((resolve) => setTimeout(resolve, backoffTime));
				continue;
			}
			throw error;
		}
	}
	throw new Error('Max retries exceeded');
}

Batch Requests

Combine multiple calls into a single request:

[
	{
		"jsonrpc": "2.0",
		"method": "eth_getBalance",
		"params": ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e", "latest"],
		"id": 1
	},
	{
		"jsonrpc": "2.0",
		"method": "eth_blockNumber",
		"params": [],
		"id": 2
	}
]

Use WebSocket Subscriptions

For real-time data, use eth_subscribe instead of polling.

# Monitoring

Monitor your usage through:

Dashboard metrics
Rate limit headers
Usage alerts

# Quota Management

Track Usage

function trackApiUsage(response) {
	const limits = {
		limit: response.headers['X-RateLimit-Limit'],
		remaining: response.headers['X-RateLimit-Remaining'],
		reset: response.headers['X-RateLimit-Reset'],
	};

	// Log or monitor usage
	console.log(`API calls remaining: ${limits.remaining}/${limits.limit}`);
}

Implement Caching

const cache = new Map();

async function getCachedBlockNumber(cacheTime = 5000) {
	const cached = cache.get('blockNumber');
	if (cached && Date.now() - cached.timestamp < cacheTime) {
		return cached.value;
	}

	const newValue = await web3.eth.getBlockNumber();
	cache.set('blockNumber', {
		value: newValue,
		timestamp: Date.now(),
	});

	return newValue;
}

# Plan Limits

Different subscription plans have different limits:

Base Limits

Request rate
Daily quota
WebSocket connections
Subscription limits

Additional Features

Archive data access
Debug methods
Trace API

Check the pricing page for detailed plan comparisons.

# Upgrade Options

If you regularly hit rate limits, consider:

Optimizing your requests
Implementing caching
Using WebSocket subscriptions
Upgrading your plan

# Error Prevention

Monitor Usage

Track request counts
Set up alerts
Review usage patterns

Optimize Requests

Batch when possible
Cache responses
Use appropriate polling intervals