birdeye-py 0.0.2

Python wrapper for birdeye.so api

birdeye-py

Features

• 🪙 BirdEye Only supports standard subscription api urls (package is still in active development)
• ♻️ Retry Strategy Sensible defaults to reliably retry/back-off fetching data from the api
• ✏️ Code Formatting Fully typed with mypy and code formatters black / isort
• ⚒️ Modern tooling using uv, ruff, and pre-commit
• 📥 GitHub Actions CI/CD to automate everything
• ↩️ Code Coverage Fully tested using tools like Codecov
• 🐍 Python Support All minor versions from 3.9 are supported

Installation

$ pip install birdeye-py

Usage

from birdeyepy import BirdEye

client = BirdEye(api_key="your-api-key") # 'x-chain' header defaults to solana
eth_client = BirdEye(api_key="your-api-key", chain="ethereum")

# DeFi

# https://public-api.birdeye.so/defi/price
client.defi.price()  # defaults to So11111111111111111111111111111111111111112

client.defi.price(
    address="Gr11mosZNZjwpqnemXNnWs9E2Bnv7R6vzaKwJTdjo8zQ",
    include_liquidity=True,  # can also use strings 'true' or 'false'
)

# https://public-api.birdeye.so/defi/history_price
client.defi.history(time_from=1732398942, time_to=1732398961)  # defaults to So11111111111111111111111111111111111111112

client.defi.history(
    time_from=1732398942,
    time_to=1732398961,
    address="Gr11mosZNZjwpqnemXNnWs9E2Bnv7R6vzaKwJTdjo8zQ",
    address_type="token",  # or 'pair'...defaults to 'token'
    type_in_time="15m"  # default
)

# Token

# https://public-api.birdeye.so/defi/tokenlist
client.token.list_all()

Documentation

See https://docs.birdeye.so/docs/overview

---

If you would like to support development efforts, tips are greatly appreciated. SOL wallet address: HKmUpKBCcZGVX8RqLRcKyjYuY23hQHwnFSHXzdon4pCH