Account Endpoints¶

Orders¶

Order Validation¶

Binance has a number of rules around symbol pair orders with validation on minimum price, quantity and total order value.

Read more about their specifics in the Filters section of the official API.

Read Understanding Binance Order Filters for more information about price and quantity filters on Binance.

It can be helpful to format the output using formatting

amount = 0.000234234
precision = 5
amt_str = "{:0.0{}f}".format(amount, precision)

Or if you have the tickSize or stepSize then use the helper to round to step size

from binance.helpers import round_step_size

amount = 0.000234234
tick_size = 0.00001
rounded_amount = round_step_size(amount, tick_size)

Fetch all orders ¶

orders = client.get_all_orders(symbol='BNBBTC', limit=10)

Place an order ¶

Place an order

Use the create_order function to have full control over creating an order

from binance.enums import *
order = client.create_order(
    symbol='BNBBTC',
    side=SIDE_BUY,
    type=ORDER_TYPE_LIMIT,
    timeInForce=TIME_IN_FORCE_GTC,
    quantity=100,
    price='0.00001')

Place a limit order

Use the helper functions to easily place a limit buy or sell order

order = client.order_limit_buy(
    symbol='BNBBTC',
    quantity=100,
    price='0.00001')

order = client.order_limit_sell(
    symbol='BNBBTC',
    quantity=100,
    price='0.00001')

Place a market order

Use the helper functions to easily place a market buy or sell order

order = client.order_market_buy(
    symbol='BNBBTC',
    quantity=100)

order = client.order_market_sell(
    symbol='BNBBTC',
    quantity=100)

Place an OCO order

Use the create_oco_order function to have full control over creating an OCO order

from binance.enums import *
order = client.create_oco_order(
    symbol='BNBBTC',
    side=SIDE_SELL,
    stopLimitTimeInForce=TIME_IN_FORCE_GTC,
    quantity=100,
    stopPrice='0.00001',
    price='0.00002')

Place a test order ¶

Creates and validates a new order but does not send it into the exchange.

from binance.enums import *
order = client.create_test_order(
    symbol='BNBBTC',
    side=SIDE_BUY,
    type=ORDER_TYPE_LIMIT,
    timeInForce=TIME_IN_FORCE_GTC,
    quantity=100,
    price='0.00001')

Check order status ¶

order = client.get_order(
    symbol='BNBBTC',
    orderId='orderId')

Cancel an order ¶

result = client.cancel_order(
    symbol='BNBBTC',
    orderId='orderId')

Get all open orders ¶

orders = client.get_open_orders(symbol='BNBBTC')

Get all orders ¶

orders = client.get_all_orders(symbol='BNBBTC')

Account¶

Get account info ¶

info = client.get_account()

Get asset balance ¶

balance = client.get_asset_balance(asset='BTC')

Get account status ¶

status = client.get_account_status()

Get account API trading status ¶

status = client.get_account_api_trading_status()

Get trades ¶

trades = client.get_my_trades(symbol='BNBBTC')

Get trade fees ¶

# get fees for all symbols
fees = client.get_trade_fee()

# get fee for one symbol
fees = client.get_trade_fee(symbol='BNBBTC')

Get asset details ¶

details = client.get_asset_details()

Get dust log ¶

log = client.get_dust_log()

Transfer dust ¶

transfer = client.transfer_dust(asset='BNZ')

Get Asset Dividend History ¶

history = client.get_asset_dividend_history()

Disable Fast Withdraw Switch ¶

client.disable_fast_withdraw_switch()

Enable Fast Withdraw Switch ¶

client.enable_fast_withdraw_switch()