Birdeye All Time Trades

BirdEye All Time Trades Tool (birdeye_all_time_trades_tool)

Retrieves comprehensive all-time trade statistics for a specific Solana token using the BirdEye API. This offers insights into a token's historical trading activity, including volumes and buy/sell pressure.

class BirdeyeAllTimeTradesInput(BaseModel):
    token_address: str # The token address for all-time trade data

---

Key Functionality:

• Fetches all-time trade data for the specified token from public-api.birdeye.so.

• Provides statistics like total trades, buy/sell counts, total volume (in token and USD), and a buy-to-sell ratio.

---

Sample Usage Queries (How an AI might use it):

• "Get the all-time trade stats for token EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm from BirdEye."

• "Show me the historical trade data for DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263."

• "What are the lifetime buy/sell volumes for 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R on BirdEye?"

• "Analyze the all-time trading activity for HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3."

• "Fetch BirdEye's all-time trade summary for mint address token_mint_address_placeholder."

• "What's the buy/sell ratio for another_token_address based on its entire history?"

• "Retrieve all-time trade volumes for contract_addr_here via BirdEye."

---

Quick Code Glance:

class BirdeyeAllTimeTradesTool(BaseTool):
    name: ClassVar[str] = "birdeye_all_time_trades_tool"
    description: ClassVar[str] = "Get comprehensive trade statistics (buys, sells, volumes) of all time..."
    args_schema: ClassVar[Type[BaseModel]] = BirdeyeAllTimeTradesInput

---

Important:

• This tool operates asynchronously (_arun) only.

• Requires a valid BirdEye API key (CONFIG.BIRDEYE_API_KEY) to be configured in the backend.

• A valid Solana token address is necessary for meaningful results.