bitmex-python

Python SDK (sync and async) for Bitmex cryptocurrency exchange with Rest and WS capabilities.

You can check the SDK docs here: SDK
You can check Bitmex's docs here: Docs
Github repo: https://github.com/ccxt/bitmex-python
Pypi package: https://pypi.org/project/bitmex-api

Installation

pip install bitmex-api

Usage

Sync

from bitmex import BitmexSync

def main():
    instance = BitmexSync({})
    ob =  instance.fetch_order_book("BTC/USDC")
    print(ob)
    #
    # balance = instance.fetch_balance()
    # order = instance.create_order("BTC/USDC", "limit", "buy", 1, 100000)

main()

Async

import sys
import asyncio
from bitmex import BitmexAsync

### on Windows, uncomment below:
# if sys.platform == 'win32':
# 	asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

async def main():
    instance = BitmexAsync({})
    ob =  await instance.fetch_order_book("BTC/USDC")
    print(ob)
    #
    # balance = await instance.fetch_balance()
    # order = await instance.create_order("BTC/USDC", "limit", "buy", 1, 100000)

    # once you are done with the exchange
    await instance.close()

asyncio.run(main())

Websockets

import sys
from bitmex import BitmexWs

### on Windows, uncomment below:
# if sys.platform == 'win32':
# 	asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

async def main():
    instance = BitmexWs({})
    while True:
        ob = await instance.watch_order_book("BTC/USDC")
        print(ob)
        # orders = await instance.watch_orders("BTC/USDC")

    # once you are done with the exchange
    await instance.close()

asyncio.run(main())

Raw call

You can also construct custom requests to available "implicit" endpoints

        request = {
            'type': 'candleSnapshot',
            'req': {
                'coin': coin,
                'interval': tf,
                'startTime': since,
                'endTime': until,
            },
        }
        response = await instance.public_post_info(request)

Available methods

REST Unified

create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={})
fetch_balance(self, params={})
fetch_closed_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_currencies(self, params={})
fetch_deposit_address(self, code: str, params={})
fetch_deposit_withdraw_fees(self, codes: Strings = None, params={})
fetch_deposits_withdrawals(self, code: Str = None, since: Int = None, limit: Int = None, params={})
fetch_funding_rate_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_funding_rates(self, symbols: Strings = None, params={})
fetch_ledger(self, code: Str = None, since: Int = None, limit: Int = None, params={})
fetch_leverages(self, symbols: Strings = None, params={})
fetch_liquidations(self, symbol: str, since: Int = None, limit: Int = None, params={})
fetch_markets(self, params={})
fetch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_ohlcv(self, symbol: str, timeframe: str = '1m', since: Int = None, limit: Int = None, params={})
fetch_open_interests(self, symbols: Strings = None, params={})
fetch_open_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_order_book(self, symbol: str, limit: Int = None, params={})
fetch_order(self, id: str, symbol: Str = None, params={})
fetch_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_positions_adl_rank(self, symbols: Strings = None, params={})
fetch_positions(self, symbols: Strings = None, params={})
fetch_settlement_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
fetch_ticker(self, symbol: str, params={})
fetch_tickers(self, symbols: Strings = None, params={})
fetch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={})
amount_to_precision(self, symbol: Str, amount: object)
calculate_rate_limiter_cost(self, api: object, method: object, path: object, params: object, config={})
cancel_all_orders_after(self, timeout: Int, params={})
cancel_all_orders(self, symbol: Str = None, params={})
cancel_order(self, id: str, symbol: Str = None, params={})
cancel_orders(self, ids: list[str], symbol: Str = None, params={})
close_position(self, symbol: str, side: OrderSide = None, params={})
convert_from_raw_cost(self, symbol: object, rawQuantity: object)
convert_from_raw_quantity(self, symbol: object, rawQuantity: object, currencySide='base')
convert_from_real_amount(self, code: object, amount: object)
convert_to_real_amount(self, code: Str, amount: Str)
describe(self)
edit_order(self, id: str, symbol: str, type: OrderType, side: OrderSide, amount: Num = None, price: Num = None, params={})
nonce(self)
set_leverage(self, leverage: int, symbol: Str = None, params={})
set_margin_mode(self, marginMode: str, symbol: Str = None, params={})
withdraw(self, code: str, amount: float, address: str, tag: Str = None, params={})

REST Raw

public_get_announcement(request)
public_get_announcement_urgent(request)
public_get_chat(request)
public_get_chat_channels(request)
public_get_chat_connected(request)
public_get_chat_pinned(request)
public_get_funding(request)
public_get_guild(request)
public_get_instrument(request)
public_get_instrument_active(request)
public_get_instrument_activeandindices(request)
public_get_instrument_activeintervals(request)
public_get_instrument_compositeindex(request)
public_get_instrument_indices(request)
public_get_instrument_usdvolume(request)
public_get_insurance(request)
public_get_leaderboard(request)
public_get_liquidation(request)
public_get_orderbook_l2(request)
public_get_porl_nonce(request)
public_get_quote(request)
public_get_quote_bucketed(request)
public_get_schema(request)
public_get_schema_websockethelp(request)
public_get_settlement(request)
public_get_stats(request)
public_get_stats_history(request)
public_get_stats_historyusd(request)
public_get_trade(request)
public_get_trade_bucketed(request)
public_get_wallet_assets(request)
public_get_wallet_networks(request)
private_get_address(request)
private_get_apikey(request)
private_get_execution(request)
private_get_execution_tradehistory(request)
private_get_globalnotification(request)
private_get_leaderboard_name(request)
private_get_order(request)
private_get_porl_snapshots(request)
private_get_position(request)
private_get_user(request)
private_get_user_affiliatestatus(request)
private_get_user_checkreferralcode(request)
private_get_user_commission(request)
private_get_user_csa(request)
private_get_user_depositaddress(request)
private_get_user_executionhistory(request)
private_get_user_getwallettransferaccounts(request)
private_get_user_margin(request)
private_get_user_quotefillratio(request)
private_get_user_quotevalueratio(request)
private_get_user_staking(request)
private_get_user_staking_instruments(request)
private_get_user_staking_tiers(request)
private_get_user_tradingvolume(request)
private_get_user_unstakingrequests(request)
private_get_user_wallet(request)
private_get_user_wallethistory(request)
private_get_user_walletsummary(request)
private_get_useraffiliates(request)
private_get_userevent(request)
private_post_address(request)
private_post_chat(request)
private_post_guild(request)
private_post_guild_archive(request)
private_post_guild_join(request)
private_post_guild_kick(request)
private_post_guild_leave(request)
private_post_guild_sharestrades(request)
private_post_order(request)
private_post_order_cancelallafter(request)
private_post_order_closeposition(request)
private_post_position_isolate(request)
private_post_position_leverage(request)
private_post_position_risklimit(request)
private_post_position_transfermargin(request)
private_post_user_addsubaccount(request)
private_post_user_cancelwithdrawal(request)
private_post_user_communicationtoken(request)
private_post_user_confirmemail(request)
private_post_user_confirmwithdrawal(request)
private_post_user_logout(request)
private_post_user_preferences(request)
private_post_user_requestwithdrawal(request)
private_post_user_unstakingrequests(request)
private_post_user_updatesubaccount(request)
private_post_user_wallettransfer(request)
private_put_guild(request)
private_put_order(request)
private_delete_order(request)
private_delete_order_all(request)
private_delete_user_unstakingrequests(request)

WS Unified

describe(self)
watch_ticker(self, symbol: str, params={})
watch_tickers(self, symbols: Strings = None, params={})
watch_liquidations(self, symbol: str, since: Int = None, limit: Int = None, params={})
watch_liquidations_for_symbols(self, symbols: list[str], since: Int = None, limit: Int = None, params={})
watch_balance(self, params={})
watch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={})
authenticate(self, params={})
watch_positions(self, symbols: Strings = None, since: Int = None, limit: Int = None, params={})
watch_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
watch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={})
watch_order_book(self, symbol: str, limit: Int = None, params={})
watch_order_book_for_symbols(self, symbols: list[str], limit: Int = None, params={})
watch_trades_for_symbols(self, symbols: list[str], since: Int = None, limit: Int = None, params={})
watch_ohlcv(self, symbol: str, timeframe: str = '1m', since: Int = None, limit: Int = None, params={})
watch_heartbeat(self, params={})

Contribution

Give us a star :star:
Fork and Clone! Awesome
Select existing issues or create a new issue.

Release files for bitmex-api 0.0.158

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bitmex-api 0.0.158
File	Size	Uploaded
bitmex_api-0.0.158.tar.gz	254.3 kB	Sep 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bitmex-api 0.0.158
File	Interpreter	ABI	Platform	Reset
bitmex_api-0.0.158-py3-none-any.whl 294.6 kB Sep 7, 2026	Python 3	none	any	Details

Total release size: 548.9 kB

Release files / bitmex_api-0.0.158.tar.gz

Download URL	bitmex_api-0.0.158.tar.gz
Size	254.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`fbc660ea5e749009bcc479986582da3171418ea391425d95179b46f4f52cd0ac`
BLAKE2b-256 checksum How to use checksums	`8c886c82fbb448078fea665a6b1aa3efafb096fd4d6d31bde480ec26726eef33`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / bitmex_api-0.0.158-py3-none-any.whl

Download URL	bitmex_api-0.0.158-py3-none-any.whl
Size	294.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d6c99ba1262de991461b2e34cd6e83139234e234ab1b154faf66eb999a3c8159`
BLAKE2b-256 checksum How to use checksums	`ea5eb18d55e803660afc6e9fd0a8822c2a7651b918635db6ae3a9f41265f9ceb`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`