Rate Limits Quick Reference

Quick lookup tables and decision trees for choosing the right tier and staying within limits.

📊 Tier Comparison at a Glance

Tier	RPS	IP Limit	Best For	Monthly Price*
FREE	5	✅ 12 req/s	Development, testing	Free
BASIC	10	❌ None	Small apps	$
PRO	10	❌ None	Production apps	$$
ENTERPRISE_50	50	❌ None	High-traffic apps	$$$
ENTERPRISE_500	500	❌ None	Mission-critical	Contact us

Note: RPS is enforced per user (shared across all access keys), not per access key.

*See pricing page for current rates

🎯 Which Tier Do I Need?

Decision Tree

How many requests per second do you need?
│
├─ Less than 5 req/s
│  └─ Do you need to bypass IP restrictions?
│     ├─ No → ✅ FREE tier
│     └─ Yes → ✅ BASIC tier
│
├─ Between 5-10 req/s
│  └─ Do you need priority support?
│     ├─ No → ✅ BASIC tier
│     └─ Yes → ✅ PRO tier
│
├─ Between 10-50 req/s
│  └─ ✅ ENTERPRISE_50 tier
│
└─ More than 50 req/s
   └─ ✅ ENTERPRISE_500 tier or custom

By Use Case

Use Case	Recommended Tier	Why
Local development	FREE	Cost-effective, sufficient for testing
Hobby project	FREE or BASIC	Low traffic, minimal cost
Startup MVP	BASIC or PRO	Room to grow, professional support
Production DApp	PRO or ENTERPRISE_50	Reliable, scalable
DEX / High-frequency	ENTERPRISE_500	Maximum throughput
Analytics platform	ENTERPRISE_50/500	Sustained high RPS
Wallet application	PRO or ENTERPRISE_50	Depends on user base
NFT marketplace	ENTERPRISE_50	Burst traffic handling

🚦 Rate Limit Behavior

FREE Tier: Dual Limits (AND Logic)

Request arrives
    ↓
Check User RPS (5 req/s) ──── FAIL → 429 Too Many Requests
    ↓ PASS
    ↓
Check IP RPS (12 req/s) ──── FAIL → 429 Too Many Requests
    ↓ PASS
    ↓
Process Request → 200 OK

Key Point: Both limits must pass for FREE tier.

Paid Tiers: Single Limit

Request arrives
    ↓
Check User RPS (tier-specific) ──── FAIL → 429 Too Many Requests
    ↓ PASS
    ↓
Process Request → 200 OK

Key Point: No IP-based restrictions on paid tiers.

📈 Scaling Strategies

Vertical Scaling (Upgrade Tier)

Current Tier	Next Tier	RPS Increase	IP Restriction Removed
FREE → BASIC	+5 req/s	5 → 10	✅
BASIC → PRO	0 req/s	10 → 10	Already removed
PRO → ENTERPRISE_50	+40 req/s	10 → 50	Already removed
ENTERPRISE_50 → ENTERPRISE_500	+450 req/s	50 → 500	Already removed

Horizontal Scaling (Multiple Keys)

Strategy	Setup	Total RPS	Cost
1 FREE key	Simple	5	Free
3 FREE keys	Key rotation	15	Free
1 BASIC key	Simple	10	$
3 BASIC keys	Key rotation	30	$$$
1 ENTERPRISE_50	Simple	50	$$$

Note: Using multiple keys requires key rotation logic in your application.

⚡ Request Budget Calculator

FREE Tier

Scenario	Math	Daily Requests
Constant rate at limit	5 req/s × 86,400s	432,000
Constant rate at 50%	2.5 req/s × 86,400s	216,000
Bursts (10 req every 2s)	Averages to 5 req/s	432,000

BASIC/PRO Tier

Scenario	Math	Daily Requests
Constant rate at limit	10 req/s × 86,400s	864,000
Constant rate at 50%	5 req/s × 86,400s	432,000

ENTERPRISE_50 Tier

Scenario	Math	Daily Requests
Constant rate at limit	50 req/s × 86,400s	4,320,000
Constant rate at 50%	25 req/s × 86,400s	2,160,000

ENTERPRISE_500 Tier

Scenario	Math	Daily Requests
Constant rate at limit	500 req/s × 86,400s	43,200,000
Constant rate at 50%	250 req/s × 86,400s	21,600,000

Important: These are RPS limits. Your daily quota (compute units) may be lower. Check both limits in your dashboard.

🔧 Common Optimization Scenarios

Scenario 1: Getting 429 on FREE Tier

Symptoms:

Response: 429 Too Many Requests
Current RPS: ~6 requests/second
Tier: FREE

Diagnosis: Exceeding 5 req/s user limit

Solutions (ranked by effort):

1. ⚡ Add client-side throttling → Immediate
2. ⚡ Implement request queuing → 1-2 hours
3. 💰 Upgrade to BASIC tier → Instant (2x RPS)
4. 🔧 Batch requests → 2-4 hours of refactoring

---

Scenario 2: Intermittent 429 on BASIC Tier

Symptoms:

Response: Mostly 200, occasional 429
Average RPS: ~8 requests/second
Peak RPS: ~15 requests/second
Tier: BASIC (10 req/s limit)

Diagnosis: Burst traffic exceeding 10 req/s

Solutions:

1. ⚡ Implement request queue with max rate → 2 hours
2. ⚡ Add caching for repeated requests → 4 hours
3. 💰 Upgrade to ENTERPRISE_50 (5x RPS) → Instant

---

Scenario 3: Need to Handle Spikes

Symptoms:

Normal traffic: 30 req/s
Peak traffic: 200 req/s (during NFT drops, events)
Current tier: ENTERPRISE_50 (50 req/s)

Solutions:

1. 💰 Upgrade to ENTERPRISE_500 → Instant
2. 🔧 Implement request queue + retry logic → 1 day
3. 🔧 Use multiple access keys with load balancing → 2 days
4. 💰 Contact sales for burst pricing → Custom

---

Scenario 4: Multi-Region Application

Symptoms:

Users: Global (US, EU, Asia)
Requirements: Low latency, high availability
Current setup: Single key, single region

Solutions:

1. 🔧 Use multiple regional keys → 1 day
2. 💰 Enterprise plan with multi-region → Contact sales
3. 🔧 Implement geo-based key selection → 2 days

📋 Error Response Cheat Sheet

Status	Error	Cause	Immediate Fix	Long-term Fix
401	Unauthorized	Missing/invalid key	Check URL format	Regenerate key in dashboard
403	Forbidden	IP blocked	Contact support	Review traffic patterns
429	Too Many Requests	RPS limit exceeded	Wait 1 second	Add rate limiting
429	Too Many Requests	Quota exceeded	Wait until tomorrow	Upgrade plan or optimize

🎓 Implementation Cheat Sheet

Minimal Rate Limiter (JavaScript)

// Simple delay-based limiter
class SimpleLimiter {
  constructor(rps) {
    this.delay = 1000 / rps;
    this.lastCall = 0;
  }

  async wait() {
    const now = Date.now();
    const timeSinceLastCall = now - this.lastCall;

    if (timeSinceLastCall < this.delay) {
      await new Promise((r) => setTimeout(r, this.delay - timeSinceLastCall));
    }

    this.lastCall = Date.now();
  }
}

// Usage (BASIC tier = 10 RPS)
const limiter = new SimpleLimiter(10);

async function makeRequest(url) {
  await limiter.wait();
  return fetch(url);
}

Production Rate Limiter (TypeScript)

// Sliding window limiter with queue
class ProductionLimiter {
  private queue: Array<{ timestamp: number; resolve: () => void }> = [];
  private processing = false;

  constructor(
    private rps: number,
    private windowMs: number = 1000,
  ) {}

  async acquire(): Promise<void> {
    return new Promise((resolve) => {
      this.queue.push({ timestamp: Date.now(), resolve });
      this.processQueue();
    });
  }

  private processQueue() {
    if (this.processing) return;
    this.processing = true;

    const process = () => {
      if (this.queue.length === 0) {
        this.processing = false;
        return;
      }

      const now = Date.now();
      const windowStart = now - this.windowMs;

      // Remove old entries
      this.queue = this.queue.filter((item) => item.timestamp > windowStart);

      // Check if we can process the next request
      if (this.queue.length <= this.rps) {
        const item = this.queue.shift()!;
        item.resolve();
        setTimeout(process, this.windowMs / this.rps);
      } else {
        setTimeout(process, 100); // Check again soon
      }
    };

    process();
  }
}

// Usage
const limiter = new ProductionLimiter(50); // ENTERPRISE_50

async function makeRequest(url: string) {
  await limiter.acquire();
  return fetch(url);
}

Batch Request Helper

// Automatically batches JSON-RPC requests
class BatchHelper {
  constructor(url, maxBatchSize = 10, flushIntervalMs = 100) {
    this.url = url;
    this.maxBatchSize = maxBatchSize;
    this.flushIntervalMs = flushIntervalMs;
    this.pendingRequests = [];
    this.timer = null;
  }

  request(method, params) {
    return new Promise((resolve, reject) => {
      this.pendingRequests.push({
        method,
        params,
        resolve,
        reject,
        id: Date.now() + Math.random(),
      });

      if (this.pendingRequests.length >= this.maxBatchSize) {
        this.flush();
      } else if (!this.timer) {
        this.timer = setTimeout(() => this.flush(), this.flushIntervalMs);
      }
    });
  }

  async flush() {
    if (this.timer) {
      clearTimeout(this.timer);
      this.timer = null;
    }

    if (this.pendingRequests.length === 0) return;

    const batch = this.pendingRequests.splice(0, this.maxBatchSize);

    const payload = batch.map((req) => ({
      jsonrpc: "2.0",
      id: req.id,
      method: req.method,
      params: req.params,
    }));

    try {
      const response = await fetch(this.url, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(payload),
      });

      const results = await response.json();

      results.forEach((result) => {
        const req = batch.find((r) => r.id === result.id);
        if (req) {
          if (result.error) {
            req.reject(result.error);
          } else {
            req.resolve(result.result);
          }
        }
      });
    } catch (error) {
      batch.forEach((req) => req.reject(error));
    }
  }
}

// Usage
const batcher = new BatchHelper("https://api.blockeden.xyz/eth/YOUR_KEY");

// These 3 calls will be batched into 1 HTTP request
const [block1, block2, block3] = await Promise.all([
  batcher.request("eth_getBlockByNumber", ["0x1", false]),
  batcher.request("eth_getBlockByNumber", ["0x2", false]),
  batcher.request("eth_getBlockByNumber", ["0x3", false]),
]);

📞 Quick Support Matrix

Issue	Severity	FREE	BASIC	PRO	ENTERPRISE_50	ENTERPRISE_500
Rate limit questions	Low	Community/Docs	Email 48h	Email 24h	Email 12h	Phone/Slack
Account issues	Medium	Email 72h	Email 48h	Email 24h	Email 12h	Phone 2h
Service outage	High	Status page	Email 24h	Email 12h	Email 4h	Phone 1h
Custom integration	-	Not available	Email quote	Priority queue	Dedicated engineer	White-glove

Contact:

• Community: Discord
• Email: support@blockeden.xyz
• Sales: sales@blockeden.xyz
• Emergency (Enterprise only): [Your dedicated contact]

---

See also:

• Full Rate Limits Documentation
• Understanding Compute Units
• API Performance Guide