# 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.

```python
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:**

```python
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.