The CoinStats API uses a credit-based system for rate limiting. Different endpoints consume different amounts of credits based on the complexity and data requirements of the request.

​
Credit System

Each API request consumes a specific number of credits:
Endpoint CategoryCredit CostDescription
Basic Market Data1-2 creditsSimple data like coin lists, basic info
Detailed Data3-5 creditsHistorical charts, detailed analytics
Wallet Operations40-50 creditsWallet balance, transaction sync
Portfolio Data8-10 creditsPortfolio management features
DeFi Data400 creditsComprehensive DeFi portfolio data

​
Managing Your Credits

​
Check Your Usage

Monitor your credit usage through the CoinStats dashboard to ensure you don’t exceed your plan limits.

​
Plan Limits

Different subscription plans have different credit limits:
PlanCredits/MonthRate LimitPrice
Free1,000,0005 req/secFree
Individual5,000,00030 req/sec$199/month
Business80,000,000100 req/sec$999/month
CustomCustomCustomContact sales

Plans & Pricing

View full pricing details and features

​
Best Practices

  • Cache responses: Store frequently requested data locally
  • Batch requests: Combine multiple requests when possible
  • Monitor usage: Track your credit consumption
  • Optimize queries: Use filters to reduce data transfer

​
Error Responses

When you exceed your credit limit, you’ll receive a 429 Too Many Requests response: 
{
  "error": "Rate limit exceeded",
  "message": "Insufficient credits for this request"
}

​
Credit Reset

Credits are typically reset monthly based on your subscription plan.