python-binance

分类: 开发与编程 | 上传者: sammchardy | 下载: 0 | 版本: v1.0（最新）

帮助开发者使用python-binance库在币安上进行交易。当代码导入 Binance、引用 Client/AsyncClient 或询问 Binance API 交易、市场数据、Websockets 或账户管理时使用。 --- # python-binance SDK 用于币安加密货币交易所的非官方 Python SDK。超过 797 种方法，涵盖现货、保证金、期货、期权、投资组合保证金和 WebSocket API。 ## 设置 ```python from binance import Client, AsyncClient # 同步客户端 client = Client(api_key, api_secret) # 异步客户端 client = wait AsyncClient.create(api_key, api_secret) # 测试网客户端 = Client(api_key, api_secret, testnet=True) # 演示/纸质交易 client = Client(api_key, api_secret, demo=True) # RSA 密钥认证 client = Client(api_key, private_key=open("key.pem").read()) # 其他 TLD（币安美国、日本等） client = Client(api_key, api_secret, tld="us") ``` ## 关键模式 1. **所有方法都返回纯 Python 字典** — 不是自定义对象。使用 `response["key"]` 访问字段。 2. **`**params` kwargs** — 大多数方法接受额外的 Binance API 参数作为关键字参数。 3. **同步/异步奇偶校验** — `Client` 和 `AsyncClient` 具有相同的方法名称。使用“await”进行异步。 4. **Enums** — 从 `binance.enums` 导入或直接使用字符串值（`"BUY"`、`"LIMIT"` 等）。 ## 方法命名约定这是最重要的模式 — 它可以让您推断方法名称： |前缀|域名 |示例| |--------|--------|---------| | `get_*` / `create_*` / `cancel_*` |现货| `get_order_book()`、`create_order()` | | `期货_*` |美元期货 | `futures_create_order()` | | `futures_coin_*` | Coin-M 期货 | `futures_coin_create_order()` | | `保证金_*` |保证金| `margin_borrow_repay()` | | `选项_*` |普通期权 | `options_place_order()` | | `papi_*` |投资组合保证金 | `papi_create_um_order()` | | `ws_*` | WebSocket 增删改查 | `ws_create_order()` | | `订单_*` |订单帮手| `order_limit_buy()` | | `流_*` |用户数据流| `stream_get_listen_key(

更新日志: Source: GitHub https://github.com/sammchardy/python-binance

目录结构

当前层级: tree/master/.agents/skills/python-binance/

📁 references/
- 📄 REFERENCE.md 1.4 KB
📄 SKILL.md 5.1 KB

SKILL.md

---
name: python-binance
description: >
  Help developers use the python-binance library for trading on Binance.
  Use when code imports binance, references Client/AsyncClient, or asks
  about Binance API trading, market data, websockets, or account management.
---

# python-binance SDK

Unofficial Python SDK for the Binance cryptocurrency exchange. 797+ methods covering Spot, Margin, Futures, Options, Portfolio Margin, and WebSocket APIs.

## Setup

```python
from binance import Client, AsyncClient

# Sync client
client = Client(api_key, api_secret)

# Async client
client = await AsyncClient.create(api_key, api_secret)

# Testnet
client = Client(api_key, api_secret, testnet=True)

# Demo/paper trading
client = Client(api_key, api_secret, demo=True)

# RSA key auth
client = Client(api_key, private_key=open("key.pem").read())

# Other TLD (Binance US, Japan, etc.)
client = Client(api_key, api_secret, tld="us")
```

## Critical Patterns

1. **All methods return plain Python dicts** — not custom objects. Access fields with `response["key"]`.
2. **`**params` kwargs** — most methods accept extra Binance API parameters as keyword arguments.
3. **Sync/async parity** — `Client` and `AsyncClient` have identical method names. Use `await` for async.
4. **Enums** — import from `binance.enums` or use string values directly (`"BUY"`, `"LIMIT"`, etc.).

## Method Naming Convention

This is the most important pattern — it lets you infer method names:

| Prefix | Domain | Example |
|--------|--------|---------|
| `get_*` / `create_*` / `cancel_*` | Spot | `get_order_book()`, `create_order()` |
| `futures_*` | USD-M Futures | `futures_create_order()` |
| `futures_coin_*` | Coin-M Futures | `futures_coin_create_order()` |
| `margin_*` | Margin | `margin_borrow_repay()` |
| `options_*` | Vanilla Options | `options_place_order()` |
| `papi_*` | Portfolio Margin | `papi_create_um_order()` |
| `ws_*` | WebSocket CRUD | `ws_create_order()` |
| `order_*` | Order helpers | `order_limit_buy()` |
| `stream_*` | User data stream | `stream_get_listen_key()` |

## Key Enums

```python
from binance.enums import *

SIDE_BUY, SIDE_SELL = "BUY", "SELL"
ORDER_TYPE_LIMIT, ORDER_TYPE_MARKET = "LIMIT", "MARKET"
ORDER_TYPE_STOP_LOSS_LIMIT = "STOP_LOSS_LIMIT"
TIME_IN_FORCE_GTC = "GTC"  # Good till cancelled
TIME_IN_FORCE_IOC = "IOC"  # Immediate or cancel
KLINE_INTERVAL_1MINUTE = "1m"
KLINE_INTERVAL_1HOUR = "1h"
KLINE_INTERVAL_1DAY = "1d"
FUTURE_ORDER_TYPE_MARKET = "MARKET"
FUTURE_ORDER_TYPE_LIMIT = "LIMIT"
```

## Common Tasks

### Get current price
```python
ticker = client.get_symbol_ticker(symbol="BTCUSDT")
print(ticker["price"])  # "50000.00000000"
```

### Get account balances
```python
account = client.get_account()
balances = [b for b in account["balances"] if float(b["free"]) > 0]
```

### Place a market buy order
```python
from binance.enums import *
order = client.create_order(
    symbol="BTCUSDT",
    side=SIDE_BUY,
    type=ORDER_TYPE_MARKET,
    quoteOrderQty=100  # spend 100 USDT
)
```

### Place a limit sell order
```python
order = client.create_order(
    symbol="BTCUSDT",
    side=SIDE_SELL,
    type=ORDER_TYPE_LIMIT,
    timeInForce=TIME_IN_FORCE_GTC,
    quantity=0.001,
    price="60000"
)
```

### Get order status
```python
order = client.get_order(symbol="BTCUSDT", orderId=12345)
print(order["status"])  # "FILLED", "NEW", "CANCELED"
```

### Cancel an order
```python
result = client.cancel_order(symbol="BTCUSDT", orderId=12345)
```

### Get historical klines (candlesticks)
```python
klines = client.get_historical_klines("BTCUSDT", Client.KLINE_INTERVAL_1HOUR, "1 day ago UTC")
# Each kline: [open_time, open, high, low, close, volume, close_time, ...]
```

### Get order book depth
```python
depth = client.get_order_book(symbol="BTCUSDT")
print(depth["bids"][:5])  # [[price, qty], ...]
```

### Futures: place an order
```python
order = client.futures_create_order(
    symbol="BTCUSDT", side="BUY", type="MARKET", quantity=0.001
)
```

### Futures: get position info
```python
positions = client.futures_position_information(symbol="BTCUSDT")
```

## WebSocket Streaming

```python
from binance import ThreadedWebsocketManager

twm = ThreadedWebsocketManager(api_key=api_key, api_secret=api_secret)
twm.start()

def handle_message(msg):
    print(msg)

twm.start_kline_socket(callback=handle_message, symbol="BTCUSDT")
twm.join()
```

### Async WebSocket
```python
from binance import AsyncClient, BinanceSocketManager

async def main():
    client = await AsyncClient.create()
    bsm = BinanceSocketManager(client)
    async with bsm.trade_socket("BTCUSDT") as ts:
        for _ in range(10):
            msg = await ts.recv()
            print(msg)
    await client.close_connection()
```

## Error Handling

```python
from binance.exceptions import BinanceAPIException

try:
    order = client.create_order(...)
except BinanceAPIException as e:
    print(e.code)       # e.g., -1013
    print(e.message)    # e.g., "Filter failure: LOT_SIZE"
    print(e.status_code)
```

## Full Reference

For the complete method reference with all 797+ methods, signatures, and parameters, see:
- `llms-full.txt` in the repository root
- `Endpoints.md` for endpoint-to-method mapping

登录后下载/点赞/收藏 ❤ 7.1K | ★ 0

python-binance

目录结构

SKILL.md

举报内容

提示