Changelog

v1.0.36 - 2026-03-24

Added - feat: USD-M futures WebSocket URL category support #1684

Fixed - fix: propagate connection errors to subscription queues #1681

v1.0.35 - 2026-02-16

Added

Fixed - fix: reconnects for websocket connection closed ok and ws-api by @pcriadoperez in https://github.com/sammchardy/python-binance/pull/1655

v1.0.34 - 2025-12-16

Added - verbose mode for inspecting requests (verbose=True) (#1642) - feat: add support for rpi orders (#1644) - feat: update futures ticker endpoint to v2 (#1650) - feat: add support for websocket algo orders (#1646) - docs: add missing doc references from async client (#1651)

Fixed

  • fix: remove duplicate import and replace type() with isinstance() (#1623)

  • fix(client): use proper exception instead of assert for US endpoints (#1641)

v1.0.33 - 2025-12-06

Fixed

  • fix: reconnect keep alive (#1637)

Added

  • moved conditional orders to the new futures algo serivce (#1639)

v1.0.32 - 2025-11-03

Fixed

  • signature encoding for non-ascii symbols in both private and public endpoints (#1619)

v1.0.30 - 2025-10-14

v1.0.31 - 2025-10-29

Fixed

  • fix signature encoding for non-ascii symbols (#1612), eg: 币安人生USDT

v1.0.30 - 2025-10-14

Fixed

  • Set default limit=None for futures_historical_klines* (fetch full range by default) (#1607)

  • fixed a typo in a method name (#1605)

  • all links updated (#1600)

  • throw readloopclosed error if trying to connect once read loop is already closed (#1593)

  • ensure spot v3 version (#1587

Added - Demo trading - websocket userdatastream.signature support, deprecate listenkey for spot market

v1.0.28 - 2025-02-27

Added

  • Add papi_get_rate_limit

  • Add docs for create_oco_order

  • Add uiKlines support

  • Add options websocket market streams

  • Add dozens of missing endpoints

v1.0.29 - 2025-05-19

Fixed

  • Ws tesnet spot URLs update

v1.0.28 - 2025-02-27

Added

  • Add papi_get_rate_limit

  • Add docs for create_oco_order

  • Add uiKlines support

  • Add options websocket market streams

  • Add dozens of missing endpoints

Fixed

  • Ws API not allowing more than 100 requests

  • Return empty json instead of throwing error on empty response

  • Json_dumps when using orjson

v1.0.27 - 2024-12-31

Added

  • Add futures_taker_long_short_ratio endpoint, thanks to @ngoclam9415

  • Add portfolio margin user data streams

Fixed

  • Close read loop before closing websocket

  • Fix threaded_stream

  • Closing keepAliveWebsocker fix

v1.0.26 - 2024-12-23

Added

  • Websockets docs

  • support for microseconds time unit

  • futures data link endpoints

  • return type to _get_account_socket thanks to @zhen1007

  • futures_index_price_constituents endpoint

Fixed

  • FuturesDepthCacheManager and OptionsDepthCacheManager to __init__

  • EDDSA random error

v1.0.25 - 2024-12-05

Added

  • borrow-repay endpoints (margin_interest_rate_history/margin_get_borrow_repay_records/margin_borrow_repay/etc)

  • futures_mark_price_klines thanks to @zhen1007

  • futures_index_price_klines and futures_premium_index_klines

  • HistoricalKlinesType enum enhanced

  • block trades endpoints (options_create_block_trade_order, options_cancel_block_trade_order, etc)

  • dapi asyn endpoints (futures_coin_account_order_history_download, futures_coin_account_order_history_download_link, etc)

Fixed

  • Removed unnecessary logs with error level

  • Remove CANCEL read_loop error log

  • Fix error type for when message queue is full

  • Fixes that if first connect fails it would not throw and let the user wait indefinitely

  • Improves error handling passing to user error type for different scenarios

v1.0.24 - 2024-11-28

Added

  • Exposed internal classes for easier subclassing

Fixed

  • Fixed package outdated structure causing import errors

v1.0.23 - 2024-11-27

Added

  • CRUD over Websockets (create/fetch/edit/cancel) through Websockets

  • orjson support

  • overridable headers per request

  • added default recvWindow parameter

  • Proxy support for Websockets

  • Gift card API

  • cancel_replace_order, cancel_all_open_orders and cancel_all_open_margin_orders thanks to @m-HD

  • missing futures_modify_order from async client

  • ruff format

  • missing endpoint for futures_edit_order

Fixed

  • updated create_oco_order endpoint

  • batch orders signature issue

  • fail_connection issue related to the websockets upgrade

  • eddsa signature issue

v1.0.22 - 2024-10-29

Added

  • futures all tickers stream

  • futures coin-m all tickers stream

Fixed

  • hang in the ThreadedApiManager

v1.0.21 - 2024-10-23

Added

  • Some new endpoints

Fixed

  • url encoding for coin-m post endpoints

  • batch order endpoint

  • Some minor bug fixes

v1.0.20 - 2024-10-22

Added

  • EDDSA authentication

  • Portfolio Margin endpoints

  • Some new futures endpoints

  • Proxy support for the AsyncClient

  • Version override is possible now through params

Fixed

  • Migrated positionRisk to v3

  • Fixed the error AttributeError(“‘Connect’ object has no attribute ‘protocol’”)

  • Some minor bug fixes

v1.0.19 - 2023-08-11

Added

  • some new futures and margin endpoints

  • pass session_params to streams for AsyncClient

Fixed

  • removed debug statements

  • options testnet URL

  • accessing msg variable before assignment

v1.0.18 - 2023-08-09

Added

  • TRAILING_STOP_MARKET option for orders

Fixed

  • futures api endpoint versions

  • margin endpoint request methods

v1.0.17 - 2023-02-21

Added

  • RSA key authentication

  • Support for api1, api2, api3, api4 base endpoints

  • binance.us staking endpoints

  • Options ticker by expiration socket

  • Staking endpoints

  • Pay and Convert endpoints

  • Futures index info endpoint

  • Open OCO Orders endpoint

  • Param to pass session params to aiohttp.ClientSession

Updated

  • Some margin endpoint versions

  • Support testnet for more streams

Fixed

  • Indefinite websocket reconnect loop

  • Crash on parsing code from some errors

v1.0.16 - 2022-04-09

Added

  • pass limit param to all kline functions

  • increase default for kline functions from 500 to 1000

  • add HistoricalKlinesType.FUTURES_COIN as option for kline functions

  • testnet URL for coin_futures_socket

Updated

  • round_step_size more accurate

Fixed

  • remove deprecated loop param

  • websockets unpinned

  • hanging websockets in exiting state

  • check start_ts after end_ts for klines

  • multi assets margin params

v1.0.15 - 2021-09-27

Added

  • Enable/disable margin account for symbol endpoints

  • Top trader long/short positions endpoint

  • Global long/short ratio endpoint

Fixed

  • fix websockets to 9.1

  • websocket reconnect updates

  • fix futures kline sockets

v1.0.14 - 2021-09-08

Fixed

  • websocket reconnecting

v1.0.13 - 2021-09-08

Added

  • Futures Depth Cache Manager

  • Futures kline websocket stream

  • Coin Futures User websocket stream

  • New Margin endpoints

  • Margin OCO order endpoints

  • Fiat endpoints

  • C2C endpoints

  • Account API permissions endpoint

Fixed

  • changed asset to coin in withdraw endpoint

v1.0.12 - 2021-06-03

Added

  • coin futures batch order function

Fixed

  • threaded websockets on python3.9

  • filter out None params in request kwargs

  • deconflict streams with same name on different websocket urls

  • reduce close timeout on websocket close to short time to reduce waiting

v1.0.10 - 2021-05-13

Added

  • futures multi-asset margin mode endpoints

  • optional symbol param to get_all_tickers

Fixed

  • start_multiplex_socket remove lower case filter on stream names

v1.0.9 - 2021-05-12

Fixed

  • start_book_ticker_socket and start_multiplex_socket to call correct async function

v1.0.8 - 2021-05-11

Added

  • old style websocket and depth cache managers as option without interacting with asyncio

Fixed

  • fixed issue with get_historical_klines in Client

  • remove print debug line

v1.0.7

Fixed

  • remove version param from get_sub_account_assets

v1.0.6

Fixed

  • fix time for authenticated stream keepalive

v1.0.5

Fixed

  • Restored access to last response on client

v1.0.4

Added

  • Futures Testnet support

  • Kline type for fetching historical klines

Fixed

  • Spot Testnet websocket URL

v1.0.3

Added

  • Spot Testnet support

v1.0.2

Added

  • start of typing to client and websockets

Fixed

  • end_str, limit, spot params in kline fetching

  • drop None values in params passed

Updated

  • more examples in docs

v1.0.1

Fixed

  • restored params for Client and AsyncClient classes

v1.0.0

Added

  • Async support for all REST endpoints

  • USDⓈ-M and Coin-M Futures websocket streams

  • Websockets use same tld as Client

  • convert type option for DepthCache

Breaking Changes

  • Supports only py3.6+

  • All wapi calls changed to sapi

  • Websockets have changed to use Asynchronous context managers

Fixed

  • get_historical_klines params

v0.7.11

Added - Vanilla Options REST endpoints - Vanilla Options websockets - Futures order type enums

Updated

  • websocket keep-alive functions for different socket types

  • dependencies

Fixed

  • change to User-Agent to avoid connection issues

v0.7.5.dev

Changed - Stock json lib to ujson (https://github.com/sammchardy/python-binance/pull/383)

v0.7.5 - 2020-02-06

Added

  • Futures REST endpoints

  • Lending REST endpoints

  • OCO Orders function create_oco_order, order_oco_buy, order_oco_sell

  • Average Price function get_avg_price

  • Support for other domains (.us, .jp, etc)

Updated

  • dependencies

Fixed

  • websocket keepalive callback not found

v0.7.4 - 2019-09-22

Added

  • symbol book ticker websocket streams

  • margin websocket stream

Updated

  • can call Client without any params

  • make response a property of the Client class so you can access response properties after a request

Fixed

  • issue with None value params causing errors

v0.7.3 - 2019-08-12

Added

  • sub account endpoints

  • dust transfer endpoint

  • asset divident history endpoint

Removed

  • deprecated withdraw fee endpoint

v0.7.2 - 2019-08-01

Added

  • margin trading endpoints

Fixed

  • depth cache clearing bug

v0.7.1 - 2019-01-23

Added

  • limit param to DepthCacheManager

  • limit param to get_historical_klines

  • update_time to DepthCache class

Updated

  • test coverage

Fixed

  • super init in Websocket class

  • removal of request params from signature

  • empty set issue in aggregate_trade_iter

v0.7.0 - 2018-08-08

Added

  • get_asset_details endpoint

  • get_dust_log endpoint

  • get_trade_fee endpoint

  • ability for multiple DepthCacheManagers to share a BinanceSocketManager

  • get_historial_klines_generator function

  • custom socket timeout param for BinanceSocketManager

Updated

  • general dependency version

  • removed support for python3.3

Fixed

  • add a super init on BinanceClientProtocol

v0.6.9 - 2018-04-27

Added

  • timestamp in milliseconds to get_historical_klines function

  • timestamp in milliseconds to aggregate_trade_iter function

Fixed

  • Don’t close user stream listen key on socket close

v0.6.8 - 2018-03-29

Added

  • get_withdraw_fee function

Fixed

  • Remove unused LISTENKEY_NOT_EXISTS

  • Optimise the historical klines function to reduce requests

  • Issue with end_time in aggregate trade iterator

v0.6.7 - 2018-03-14

Fixed

  • Issue with get_historical_klines when response had exactly 500 results

  • Changed BinanceResponseException to BinanceRequestException

  • Set default code value in BinanceApiException properly

v0.6.6 - 2018-02-17

Fixed

  • User stream websocket keep alive strategy updated

v0.6.5 - 2018-02-13

Fixed

  • get_historical_klines response for month interval

v0.6.4 - 2018-02-09

Added

  • system status endpoint get_system_status

v0.6.3 - 2018-01-29

Added

  • mini ticker socket function start_miniticker_socket

  • aggregate trade iterator aggregate_trade_iter

Fixes

  • clean up interval_to_milliseconds logic

  • general doc and file cleanups

v0.6.2 - 2018-01-12

Fixes

  • fixed handling Binance errors that aren’t JSON objects

v0.6.1 - 2018-01-10

Fixes

  • added missing dateparser dependency to setup.py

  • documentation fixes

v0.6.0 - 2018-01-09

New version because why not.

Added

  • get_historical_klines function to fetch klines for any date range

  • ability to override requests parameters globally

  • error on websocket disconnect

  • example related to blog post

Fixes

  • documentation fixes

v0.5.17 - 2018-01-08

Added

  • check for name parameter in withdraw, set to asset parameter if not passed

Update

  • Windows install error documentation

Removed

  • reference to disable_validation in documentation

v0.5.16 - 2018-01-06

Added

  • addressTag documentation to withdraw function

  • documentation about requests proxy environment variables

Update

  • FAQ for signature error with solution to regenerate API key

  • change create_order to create_test_order in example

Fixed

  • reference to BinanceAPIException in documentation

v0.5.15 - 2018-01-03

Fixed

  • removed all references to WEBSOCKET_DEPTH_1 enum

v0.5.14 - 2018-01-02

Added

  • Wait for depth cache socket to start

  • check for sequential depth cache messages

Updated

  • documentation around depth websocket and diff and partial responses

Removed

  • Removed unused WEBSOCKET_DEPTH_1 enum

  • removed unused libraries and imports

v0.5.13 - 2018-01-01

Fixed

  • Signature invalid error

v0.5.12 - 2017-12-29

Added

  • get_asset_balance helper function to fetch an individual asset’s balance

Fixed

  • added timeout to requests call to prevent hanging

  • changed variable type to str for price parameter when creating an order

  • documentation fixes

v0.5.11 - 2017-12-28

Added

  • refresh interval parameter to depth cache to keep it fresh, set default at 30 minutes

Fixed

  • watch depth cache socket before fetching order book to replay any messages

v0.5.10 - 2017-12-28

Updated

  • updated dependencies certifi and cryptography to help resolve signature error

v0.5.9 - 2017-12-26

Fixed

  • fixed websocket reconnecting, was no distinction between manual close or network error

v0.5.8 - 2017-12-25

Changed

  • change symbol parameter to optional for get_open_orders function

  • added listenKey parameter to stream_close function

Added

  • get_account_status function that was missed

v0.5.7 - 2017-12-24

Changed

  • change depth cache callback parameter to optional

Added

  • note about stopping Twisted reactor loop to exit program

v0.5.6 - 2017-12-20

Added

  • get_symbol_info function to simplify getting info about a particular symbol

v0.5.5 - 2017-12-19

Changed

  • Increased default limit for order book on depth cache from 10 to 500

v0.5.4 - 2017-12-14

Added

  • symbol property made public on DepthCache class

Changed

  • Enums now also accessible from binance.client.Client and binance.websockets.BinanceSocketManager

v0.5.3 - 2017-12-09

Changed

  • User stream refresh timeout from 50 minutes to 30 minutes

  • User stream socket listen key change check simplified

v0.5.2 - 2017-12-08

Added

  • start_multiplex_socket function to BinanceSocketManager to create multiplexed streams

v0.5.1 - 2017-12-06

Added

  • Close method for DepthCacheManager

Fixes

  • Fixed modifying array error message when closing the BinanceSocketManager

v0.5.0 - 2017-12-05

Updating to match new API documentation

Added

  • Recent trades endpoint

  • Historical trades endpoint

  • Order response type option

  • Check for invalid user stream listen key in socket to keep connected

Fixes

  • Fixed exchange info endpoint as it was renamed slightly

v0.4.3 - 2017-12-04

Fixes

  • Fixed stopping sockets where they were reconnecting

  • Fixed websockets unable to be restarted after close

  • Exception in parsing non-JSON websocket message

v0.4.2 - 2017-11-30

Removed

  • Removed websocket update time as 0ms option is not available

v0.4.1 - 2017-11-24

Added

  • Reconnecting websockets, automatic retry on disconnect

v0.4.0 - 2017-11-19

Added

  • Get deposit address endpoint

  • Upgraded withdraw endpoints to v3

  • New exchange info endpoint with rate limits and full symbol info

Removed

  • Order validation to return at a later date

v0.3.8 - 2017-11-17

Fixes

  • Fix order validation for market orders

  • WEBSOCKET_DEPTH_20 value, 20 instead of 5

  • General tidy up

v0.3.7 - 2017-11-16

Fixes

  • Fix multiple depth caches sharing a cache by initialising bid and ask objects each time

v0.3.6 - 2017-11-15

Fixes

  • check if Reactor is already running

v0.3.5 - 2017-11-06

Added

  • support for BNB market

Fixes

  • fixed error if new market type is created that we don’t know about

v0.3.4 - 2017-10-31

Added

  • depth parameter to depth socket

  • interval parameter to kline socket

  • update time parameter for compatible sockets

  • new enums for socket depth and update time values

  • better websocket documentation

Changed

  • Depth Cache Manager uses 0ms socket update time

  • connection key returned when creating socket, this key is then used to stop it

Fixes

  • General fixes

v0.3.3 - 2017-10-31

Fixes

  • Fixes for broken tests

v0.3.2 - 2017-10-30

Added

  • More test coverage of requests

Fixes

  • Order quantity validation fix

v0.3.1 - 2017-10-29

Added

  • Withdraw exception handler with translation of obscure error

Fixes

  • Validation fixes

v0.3.0 - 2017-10-29

Added

  • Withdraw endpoints

  • Order helper functions

v0.2.0 - 2017-10-27

Added

  • Symbol Depth Cache

v0.1.6 - 2017-10-25

Changes

  • Upgrade to v3 signed endpoints

  • Update function documentation

v0.1.5 - 2017-09-12

Changes

  • Added get_all_tickers call

  • Added get_orderbook_tickers call

  • Added some FAQs

Fixes

  • Fix error in enum value

v0.1.4 - 2017-09-06

Changes

  • Added parameter to disable client side order validation

v0.1.3 - 2017-08-26

Changes

  • Updated documentation

Fixes

  • Small bugfix

v0.1.2 - 2017-08-25

Added

  • Travis.CI and Coveralls support

Changes

  • Validation for pairs using public endpoint

v0.1.1 - 2017-08-17

Added

  • Validation for HSR/BTC pair

v0.1.0 - 2017-08-16

Websocket release

Added

  • Websocket manager

  • Order parameter validation

  • Order and Symbol enums

  • API Endpoints for Data Streams

v0.0.2 - 2017-08-14

Initial version

Added

  • General, Market Data and Account endpoints