margin.rst

Margin Trading Endpoints

Market Data

Get margin asset info

info = client.get_margin_asset(asset='BNB')

Get margin symbol info

info = client.get_margin_symbol(symbol='BTCUSDT')

Get margin price index

info = client.get_margin_price_index(symbol='BTCUSDT')

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.

It can be helpful to format the output using the following snippet

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

Fetch all margin_orders

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

Place a margin order

Place an order

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

from binance.enums import *
order = client.create_margin_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_margin_order(
    symbol='BNBBTC',
    orderId='orderId')

Cancel a margin order

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

Get all open margin orders

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

Get all margin orders

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

Account

Get margin account info

info = client.get_margin_account()

Transfer spot to margin

transaction = client.transfer_spot_to_margin(asset='BTC', amount='1.1')

Transfer margin to spot

transaction = client.transfer_margin_to_spot(asset='BTC', amount='1.1')

Get max transfer amount

details = client.get_max_margin_transfer(asset='BTC')

Trades

Get all margin trades

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

Loans

Create loan

transaction = client.create_margin_loan(asset='BTC', amount='1.1')

Repay loan

transaction = client.repay_margin_loan(asset='BTC', amount='1.1')

Get loan details

details = client.get_margin_loan_details(asset='BTC', txId='100001')

Get repay details

details = client.get_margin_repay_details(asset='BTC', txId='100001')

Get max loan amount

details = client.get_max_margin_loan(asset='BTC')