Rate Limiting
Birdeye Data Services (BDS) provides powerful APIs for accessing and analyzing data. To ensure fair usage and maintain system stability, BDS implements rate limiting.
Per User Account Rate Limit
BDS applies a rate limit at the user account level. This rate limit dictates the total number of requests that can be made across all APIs associated with a user account within a specified time frame. Birdeye's data APIs are designed to cater to users with varying needs, and as such, we offer different tiers of access with corresponding rate limits. This page outlines the rate limits for each tier: Free, Premium, Business, and Enterprise. View details for each tiers below.
Your Rate Limit is Per User Account
It's important to note that the actual rate limit that is applied when you use BDS APIs is PER ACCOUNT rather than per individual API. This means that the rate limit applies to the total number of requests made across all APIs associated with your Birdeye Data Services account.
*rpm: requests per minute
Per API Rate Limit
For most APIs within Birdeye Data Services, a very high limit is applied and our clients can query as much as their user account rate limit allows. However there are some exceptions for the heavier APIs that have lower rate limit:
Wallet API Group
It's important to note that endpoints belonging to the Wallet API group have a different rate limit due to their sensitive nature and potential for high-frequency updates. The rate limit for endpoints within the Wallet API group is set to 30 requests per minute (rpm). This stricter rate limit helps to mitigate excessive traffic and maintain optimal performance for these critical endpoints.
These endpoints include:
| No. | API | Description | Endpoint | Rate Limit (rpm) |
|---|---|---|---|---|
| 1 | List of Supported Chains | Provides a list of supported blockchains that are available for wallet integration through the Birdeye APIs. | https://docs.birdeye.so/reference/get_v1-wallet-list-supported-chain | 30 |
| 2 | Wallet - Portfolio - Selected Chain | Access detailed information about a user's portfolio, including current holdings, transaction history, and performance metrics. | https://docs.birdeye.so/reference/get_v1-wallet-token-list | 30 |
| 3 | Wallet - Portfolio - Multichain | Retrieve portfolio data across multiple blockchain networks, providing a comprehensive view of the user's assets. | https://docs.birdeye.so/reference/get_v1-wallet-multichain-token-list | 30 |
| 4 | Wallet - Token Balance | Check wallet's balance of a specific token. | https://docs.birdeye.so/reference/get_v1-wallet-token-balance | 30 |
| 5 | Wallet - Transaction List - Selected Chain | Retrieve portfolio data of a wallet in a specific blockchain network, providing a comprehensive view of the user's assets. | https://docs.birdeye.so/reference/get_v1-wallet-tx-list | 30 |
| 6 | Wallet - Transaction List - Multichain | Access a consolidated transaction history that spans various blockchain networks, providing users with a comprehensive record of their multichain activities. | https://docs.birdeye.so/reference/get_v1-wallet-multichain-tx-list | 30 |
| 7 | Transaction Simulation | Retrieve a preview of transactions for users to check before they finalize and sign the transaction. | https://docs.birdeye.so/reference/post_v1-wallet-simulate | 30 |
Managing Rate Limits:
To ensure optimal performance and prevent exceeding your rate limit, consider the following best practices:
- Monitor Usage: Keep track of your API usage to stay within your allotted rate limit. Monitoring tools and dashboards can help you track usage patterns and identify any potential issues.
- Prioritize Requests: Prioritize your API requests based on their importance and frequency. Allocate resources efficiently to ensure critical operations are not hindered by rate limits.
- Implement Backoff Strategies: Implement backoff strategies to gracefully handle rate limit exceeded errors. This may include implementing exponential backoff or retry-after mechanisms to retry failed requests after a delay.
- Upgrade Packages: If you consistently find yourself hitting the rate limit of your current package, consider upgrading to a higher-tier package with a higher rate limit to accommodate your growing needs.
By understanding and effectively managing the rate limits associated with Birdeye Data Services packages, you can optimize your usage of our APIs and unlock the full potential of our data-driven solutions.
Usage Guidelines
API Key Requirement: All tiers require an API key for authentication. Details
Rate Limit Enforcement: Adhering to the specified rate limits is essential to ensure fair usage and optimal performance for all users.
Upgrade Options: Users interested in higher tiers with expanded features can upgrade their subscription through the Birdeye dashboard.
Enterprise Customization: Enterprises seeking specialized data access and rate limits can reach out to our sales team for personalized solutions.
Need Assistance?
If you have any questions, encounter issues, or require assistance with rate limits or tier upgrades, please contact our sales team or support HERE. We are here to help you make the most out of Birdeye's data APIs! 🚀📊
Updated 5 months ago