mcpField
B
binance-api-usage

binance-api-usage

github.com/jkparkOther040 installsUpdated 35w ago
Repository

About binance-api-usage

binance-api-usage is a skill for interacting with Binance through the python-binance wrapper. It covers market data, account operations, order execution, and WebSocket streams, with example scripts and key-handling guidance.

Key features

  1. 01Fetch prices, order books, and historical candles
  2. 02Check balances and manage account settings
  3. 03Place market, limit, and OCO orders
  4. 04Receive real-time data over WebSockets
  5. 05Use example scripts and key-handling guidance

Use cases

  1. 01Review Binance market prices and historical data
  2. 02Check balances and manage a portfolio
  3. 03Place orders or subscribe to live market updates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jkpark/agent-skills --skill binance-api-usage

After installing, type/binance-api-usagein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
.env.example
references/
api_usage.md
scripts/
async_sockets.py
basic_ops.py
historical_data.py
order_examples.py

Details

From the project README

Binance API Usage Skill

This skill provides a structured way to interact with the Binance exchange using the python-binance Python wrapper.

Core Workflows

1. Market Data Retrieval

Fetch current prices, order books, or historical K-line (candle) data.

2. Account & Portfolio Management

Check balances and manage account settings.

3. Order Execution

Place Market, Limit, or OCO (One-Cancels-the-Other) orders.

4. Real-time Streaming (WebSockets)

Stream ticker updates, trade data, or account updates using asyncio.

Best Practices

  • Security: Always use environment variables (BINANCE_API_KEY, BINANCE_API_SECRET or BINANCE_SECRET_KEY) instead of hardcoding keys.

  • .env file (required): Place your API keys in a .env file at the project root. If .env does not exist, create it from the provided template:

    cp skills/binance-trader/assets/.env.example .env
# then edit .env and fill in your keys

    Scripts shipped with this skill will automatically look for .env in the script directory, the test/ folder, and the project root.

  • Error Handling: Wrap API calls in try-except blocks to handle BinanceAPIException.

  • Rate Limits: Be mindful of Binance's rate limits (weight-based).

  • Testnet: Use testnet=True during development to avoid losing real funds.

Resources

Comments

Markdown supported