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.

TierAPI Endpoints AccessRate Limit per account (rpm*)
StandardLimited to 4 specific endpoints. Details.800
PremiumFull set of all APIs available. Details1,000
BusinessFull set of APIs available. Details
Websocket Access Available
1,500
EnterpriseTailored to the specific needs of the enterprise.Custom

*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.APIDescriptionEndpointRate Limit (rpm)
1List of Supported ChainsProvides 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-chain30
2Wallet - Portfolio - Selected ChainAccess detailed information about a user's portfolio, including current holdings, transaction history, and performance metrics.https://docs.birdeye.so/reference/get_v1-wallet-token-list30
3Wallet - Portfolio - MultichainRetrieve 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-list30
4Wallet - Token BalanceCheck wallet's balance of a specific token.https://docs.birdeye.so/reference/get_v1-wallet-token-balance30
5Wallet - Transaction List - Selected ChainRetrieve 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-list30
6Wallet - Transaction List - MultichainAccess 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-list30
7Transaction SimulationRetrieve a preview of transactions for users to check before they finalize and sign the transaction.https://docs.birdeye.so/reference/post_v1-wallet-simulate30

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! πŸš€πŸ“Š