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.

Last updated