Rate Limits

Overview

TXCloud implements rate limiting to ensure fair usage and maintain API stability. Rate limits vary by plan and endpoint type.

Rate Limit Tiers

Plan	Requests/Minute	Requests/Day	Burst Limit
Free	60	1,000	10
Starter	300	10,000	50
Growth	1,000	100,000	100
Enterprise	Custom	Custom	Custom

Burst limit is the maximum number of concurrent requests allowed.

Endpoint-Specific Limits

Some endpoints have additional limits:

Endpoint	Limit	Window
`POST /identity/verify`	100/min	Per API key
`POST /transactions/score`	1,000/min	Per API key
`POST /watchlist/screen`	500/min	Per API key
`GET //analytics/`	30/min	Per API key

Rate Limit Headers

Every API response includes rate limit information in the headers:

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1705312800
X-RateLimit-Window: 60

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the window
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when the window resets
`X-RateLimit-Window`	Window duration in seconds

Handling Rate Limits

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 30 seconds.",
    "type": "rate_limit_error",
    "retry_after": 30
  }
}

Implementing Retry Logic

async function makeRequestWithRetry(fn, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429 && attempt < maxRetries - 1) {
        const retryAfter = error.headers['retry-after'] || 30;
        console.log(`Rate limited. Retrying in ${retryAfter}s...`);
        await sleep(retryAfter * 1000);
        continue;
      }
      throw error;
    }
  }
}

// Usage
const verification = await makeRequestWithRetry(() => 
  txcloud.identity.verify({ ... })
);

import time
from txcloud.exceptions import RateLimitError

def make_request_with_retry(fn, max_retries=3):
    for attempt in range(max_retries):
        try:
            return fn()
        except RateLimitError as e:
            if attempt < max_retries - 1:
                retry_after = e.retry_after or 30
                print(f"Rate limited. Retrying in {retry_after}s...")
                time.sleep(retry_after)
                continue
            raise

# Usage
verification = make_request_with_retry(
    lambda: txcloud.identity.verify(...)
)

Best Practices

Implement Exponential Backoff

Use exponential backoff for retries:

const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
await sleep(delay);

Use Caching

Cache responses when possible to reduce API calls:

Cache verification results by ID
Cache user risk profiles
Cache configuration data

Batch Requests

Use batch endpoints when available:

// Instead of multiple single calls
await txcloud.watchlist.screenBatch({
  entities: [entity1, entity2, entity3]
});

Monitor Usage

Track your API usage in the dashboard to predict rate limit issues.

Increasing Your Limits

Need higher rate limits? Options include:

Upgrade your plan — Higher plans have higher limits
Request a limit increase — Contact sales for custom limits
Optimize your integration — Reduce unnecessary calls

Contact Sales

Discuss custom rate limits for enterprise needs

Monitoring Usage

Track your API usage in the dashboard:

// Get your current usage
const usage = await txcloud.developers.usage.summary({
  period: '30d'
});

console.log('Total requests:', usage.total_requests);
console.log('Rate limit hits:', usage.rate_limit_hits);

Set up alerts in your dashboard to get notified when you’re approaching rate limits.

Getting Started

Core Concepts

Guides

SDKs

Resources

Overview

Rate Limit Tiers

Endpoint-Specific Limits

Rate Limit Headers

Handling Rate Limits

Implementing Retry Logic

Best Practices

Increasing Your Limits

Contact Sales

Monitoring Usage

​Overview

​Rate Limit Tiers

​Endpoint-Specific Limits

​Rate Limit Headers

​Handling Rate Limits

​Implementing Retry Logic

​Best Practices

​Increasing Your Limits

Contact Sales

​Monitoring Usage

Overview

Rate Limit Tiers

Endpoint-Specific Limits

Rate Limit Headers

Handling Rate Limits

Implementing Retry Logic

Best Practices

Increasing Your Limits

Monitoring Usage