Features

Install

pip install easy-binance

uv venv .venv
uv pip install -e .[dev]

Credentials

Expected variable names:

BINANCE_API_KEY=...
BINANCE_API_SECRET=...

CLI Examples

List products

easy-binance products

List REST methods for USDⓈ-M Futures

easy-binance methods usds-futures rest

Describe a method

easy-binance describe usds-futures rest exchange_information

Call a public REST endpoint

easy-binance call usds-futures rest exchange_information

Call a WebSocket API endpoint

easy-binance call usds-futures websocket-api order_book --param symbol=BTCUSDT

Listen to a WebSocket stream

easy-binance listen usds-futures aggregate_trade_streams --param symbol=btcusdt --duration 5

Raw REST request via official SDK

easy-binance call usds-futures rest send_request \
  --param endpoint=/fapi/v1/exchangeInfo \
  --param method=GET

Python Examples

REST call

from easy_binance import EasyBinance

client = EasyBinance()

info = client.call("usds-futures", "rest", "exchange_information")
print(info["data"]["timezone"])

WebSocket API call

book = client.call(
    "usds-futures",
    "websocket-api",
    "order_book",
    params={"symbol": "BTCUSDT"},
)
print(book["data"])

Stream subscription

from easy_binance import EasyBinance

client = EasyBinance()
messages = client.listen(
    "usds-futures",
    "aggregate_trade_streams",
    params={"symbol": "btcusdt"},
    duration=3,
    max_messages=2,
)
print(messages)

Use as Agent Skill

The skills/easy-binance/SKILL.md file is a skill manifest that teaches AI agents how to use this tool autonomously. It covers:

• Install & verification steps
• Credential resolution
• Product / API / method discovery workflow
• CLI and Python calling conventions
• Parameter encoding rules
• Safe operating defaults (bounded streams, describe-before-call)
• Failure handling & recovery

Supported agent platforms

Project Structure

easy-binance/
├── skills/easy-binance/
│   └── SKILL.md        # Agent skill manifest
├── src/easy_binance/
│   ├── cli.py          # Typer CLI entrypoint
│   ├── core.py         # Unified facade logic
│   ├── config.py       # Credential resolution & .env loading
│   ├── products.py     # Product registry
│   ├── formatting.py   # Rich output formatting
│   ├── utils.py        # Shared helpers
│   └── errors.py       # Custom exceptions
├── tests/
├── pyproject.toml
└── README.md

License

This project is licensed under the Apache License 2.0.