Binance API 從零到第一筆下單：完整教程

pip install python-binance

from binance.client import Client

# API Key 建議從環境變數讀取，不要硬編碼
import os
api_key = os.environ["BINANCE_API_KEY"]
api_secret = os.environ["BINANCE_API_SECRET"]

client = Client(api_key, api_secret)

# 查詢賬戶資訊
account = client.get_account()

# 顯示非零餘額
print("當前餘額：")
for asset in account["balances"]:
    free = float(asset["free"])
    locked = float(asset["locked"])
    if free > 0 or locked > 0:
        print(f"  {asset['asset']}: 可用 {free}, 鎖定 {locked}")

# 查詢 BTC/USDT 當前價格
ticker = client.get_symbol_ticker(symbol="BTCUSDT")
print(f"BTC 當前價：{ticker['price']}")

# 查詢 24 小時行情
stats = client.get_ticker(symbol="BTCUSDT")
print(f"24h 最高：{stats['highPrice']}")
print(f"24h 最低：{stats['lowPrice']}")
print(f"24h 成交量：{stats['volume']} BTC")

# 查詢 K 線資料（最近 10 根 1小時 K 線）
klines = client.get_klines(
    symbol="BTCUSDT",
    interval=Client.KLINE_INTERVAL_1HOUR,
    limit=10
)

for k in klines:
    timestamp = k[0]
    open_price = float(k[1])
    close_price = float(k[4])
    volume = float(k[5])
    print(f"開盤：{open_price:.2f}，收盤：{close_price:.2f}，成交量：{volume:.2f}")

from binance.client import Client

# 測試網 API Key
client = Client(
    api_key="你的測試網API_KEY",
    api_secret="你的測試網SECRET",
    testnet=True         # 關鍵引數，指向測試環境
)

# 下限價買單（BTC/USDT，買 0.001 BTC，價格 20000 USDT）
order = client.create_order(
    symbol="BTCUSDT",
    side=Client.SIDE_BUY,
    type=Client.ORDER_TYPE_LIMIT,
    timeInForce=Client.TIME_IN_FORCE_GTC,
    quantity=0.001,
    price="20000"
)

print(f"訂單 ID：{order['orderId']}")
print(f"狀態：{order['status']}")

# 查詢訂單狀態
status = client.get_order(
    symbol="BTCUSDT",
    orderId=order['orderId']
)
print(f"當前狀態：{status['status']}")

# 取消訂單
client.cancel_order(
    symbol="BTCUSDT",
    orderId=order['orderId']
)
print("訂單已取消")

from binance import ThreadedWebsocketManager

def handle_ticker(msg):
    """處理實時價格推送"""
    if msg['e'] == 'error':
        print(f"錯誤：{msg['m']}")
        return
    
    price = float(msg['c'])         # 最新成交價
    volume = float(msg['v'])        # 24h 成交量
    print(f"BTC 價格：{price:.2f}，24h 成交量：{volume:.2f}")

# 啟動 WebSocket 管理器
twm = ThreadedWebsocketManager(api_key=api_key, api_secret=api_secret)
twm.start()

# 訂閱 BTC/USDT 實時 ticker
twm.start_symbol_ticker_socket(callback=handle_ticker, symbol="BTCUSDT")

# 執行 30 秒後停止
import time
time.sleep(30)
twm.stop()