Description
Account & Usage endpoints help you monitor your API consumption and usage breakdowns so you can:- Track usage patterns for the current billing period
- Ensure your applications are within their configured rate limits
- Identify which datasets and endpoints are most frequently accessed
- Validate that automation is behaving as expected (no runaway queries)
Endpoint Matrix
| Endpoint | Summary |
|---|---|
GET /usage | Retrieve API usage statistics and rate limit status |
Key Concepts
- Subscription Plans: Access is based on your chosen tier (Basic, Standard, or Platinum).
- Billing Period: Usage is tracked within your plan’s monthly billing window.
- Rate Limits: Each plan comes with specific rate limits (Requests Per Second) to ensure fair use and stability.
- Usage by Dataset: Responses include per-dataset usage so you can understand your data access patterns.
Best Practices
- Poll
/usageon a schedule (hourly or daily) to monitor application growth and performance. - Use efficient filtering and ranges to keep your application response times low.
- Use cursor-based pagination for large datasets.
See Also
- Pricing — BlockDB subscription tiers
- Rate Limiting — RPS limits and quotas
- Authorization — API key usage and auth