This is py-bingx-d

Updated 20 Jun 2024 ⏰

py-bingx-d is an unofficial Python wrapper for the BingX Perpetual Swap API. You can use this package to create trading bots. Make sure to read my disclaimer and consider starring this project.

Usage

Register an account on BingX.

Create an API and make sure you copy your Secret Key before leaving the page. 🗝

pip install py-bingx-d

from bingx.api import BingxAPI

API_KEY = '<api_public_key>'
SECRET_KEY = '<api_secret_key>'

bingx = BingxAPI(API_KEY, SECRET_KEY, demo=False, timestamp="local") # For use VST demo account set demo to True
order_data = bingx.open_market_order('BTC-USDT', 'LONG', 0.01, tp="63277", sl="60658")

Functions 🧰

py-bingx was written with the goal of being user-friendly. Feel free to ask your questions and state any bugs/issues with the code.

You can find the list of py-bingx functions below:

Market Data Functions 💹

• get_all_contracts() - Gets a list of all contracts/trading pairs available on Bingx
• get_latest_price(pair) - Gets the latest price for a trading pair 💱
• get_market_depth(pair, limit) - Gets the order book depth data for a trading pair 📊
• get_latest_trade(pair) - Gets recent trades for a trading pair 💸
• get_latest_funding(pair) - Gets latest funding rate for a trading pair 💵
• get_index_price(pair) - Gets index price for a trading pair 📈
• get_market_price(pair) - Gets market price for a trading pair 📉
• get_funding_history(pair) - Gets historical funding rate data for a trading pair 📜
• get_kline_data(pair, interval, start_time, end_time, limit) - Gets candlestick/kline data for a trading pair 🕯
• get_open_positions(pair) - Gets open interest data for a trading pair 👀
• get_tiker(pair) - Gets ticker data including 24hr prices and volumes 📣
• get_current_optimal_price(pair) - Gets best bid and offer prices for a trading pair 💰

Account Data Functions 👤

• get_perpetual_balance() - Get user account balance info 💳
• get_my_perpetual_swap_positions(pair) - Get user open positions for a trading pair 📈
• get_fee_rate() - Get fee rate for trading 💸

Trading Functions 📈

• open_market_order() - Opens a market order to buy/sell a trading pair 💹
• close_market_order() - Closes an open market order ❌
• place_trigger_market_order() - Places a stop-trigger market order ⏱
• open_limit_order() - Opens a limit order for a trading pair 🎯
• close_limit_order() - Closes an open limit order ❌
• place_trigger_limit_order() - Places a stop-trigger limit order ⏱
• place_trailing_stop_order() - Places a trailing stop order 📉
• place_test_order() - Places a test order that does not execute 🧪
• close_all_positions() - Closes all open positions for user ❌
• cancel_order() - Cancels a pending order ❌
• cancel_all_orders_of_symbol() - Cancels all pending orders for a trading pair ❌
• cancel_batch_orders() - Cancels multiple pending orders ❌

Examples 📝

Pay attention to some examples:

• Account Info:

Use this code to get balance , equity , used margin , free margin and floating tp of your account

from bingx.api import BingxAPI

API_KEY = '<api_public_key>'
SECRET_KEY = '<api_secret_key>'

bingx = BingxAPI(API_KEY, SECRET_KEY, demo=False, timestamp="local") # For use VST demo account set demo to True
account_info = bingx.get_perpetual_balance()

balance = "{:,.0f} $".format(float(account_info['data']['balance'].get('balance', None)))
equity = "{:,.0f} $".format(float(account_info['data']['balance'].get('equity', None)))
used_margin="{:,.0f} $".format(float(account_info['data']['balance'].get('usedMargin', None)))
free_margin = "{:,.0f} $".format(float(account_info['data']['balance'].get('availableMargin', None)))
float_tp = "{:,.0f} $".format(float(account_info['data']['balance'].get('unrealizedProfit', None)))

• Open positions / Pending orders / Last price

bingx = BingxAPI(API_KEY, SECRET_KEY, demo=False, timestamp="local")

open_positions = bingx.get_my_perpetual_swap_positions(symbol)
pending_orders = bingx.query_pending_orders(symbol)
last_price = float(bingx.get_latest_price(symbol))

• All pending orders

Use this code to get all pending orders such as tp's

bingx = BingxAPI(API_KEY, SECRET_KEY, demo=False, timestamp="local")

all_pending_orders = bingx.query_pending_orders(symbol)

• Open limit order / set tp

Use this code to open limit order , Set TP for open order

bingx = BingxAPI(API_KEY, SECRET_KEY, demo=False, timestamp="local")

limit_order = bingx.open_limit_order(symbol, "LONG", price, vol)

market_order = bingx.open_market_order(symbol, "LONG", vol)
tp_order = bingx.open_limit_order(symbol,"LONG",tp_price,tp_vol,working_type="CONTRACT_PRICE",stop_price=tp_price,side="SELL",trade_type='TAKE_PROFIT')

Disclaimer 📜

This open source code is provided "as is" without warranty of any kind. The author makes no representations or warranties about the accuracy, completeness, or suitability of this code for any purpose. Use of this code is at your own risk.

The author is not affiliated with BingX and is not liable for any damages arising from the use of this code. Cryptocurrency trading involves substantial risk of loss. You should not rely on this code as your sole method of trading. No promises or guarantees are made regarding the performance of any trades executed using this code. Always do your own research and due diligence before executing any trades.

This code is still under developement and may contain bugs and errors. Use at your own discretion.