- New
/contract/private/modify-limit-order
Modify Limit Order (SIGNED)
- Update
/contract/private/submit-order
Submit Order (SIGNED): Add new request field stp_mode
- Logging: Added daily polling log files
- Websocket: Output detailed log when exception occurs;Add a sample to subscribe to 1000 topics
- New
/account/v1/withdraw/address/list
Withdraw Address (KEYED)/contract/public/markprice-kline
Get MarkPrice K-line
- Update
/account/v1/currencies
Get Currencies: Add new request field currencies/account/v2/deposit-withdraw/history
Get Deposit And Withdraw History (KEYED): Add new request field startTime and endTime
- Fix the issue that Spot WebSocket login failure
- New
/contract/private/submit-trail-order
Submit Trail Order (SIGNED)/contract/private/cancel-trail-order
Cancel Trail Order (SIGNED)/contract/public/funding-rate-history
Query Funding Rate History/contract/public/transaction-history
Query Transaction History (KEYED)
- Update
/contract/private/submit-order
Submit Order (SIGNED): Remove the Request Parameters related replacing trail orders/contract/private/modify-plan-order
Modify Plan Order (SIGNED): Remove the Request Parameters client_order_id
- The domain name
wss://openapi-ws.bitmart.com
will not provide Futures 1.0 Websocket services. Please use the domain namewss://openapi-ws-v2.bitmart.com
to access Futures 2.0 Websocket services - Change the value of the variable FUTURES_PUBLIC_WS_URL
from
wss://openapi-ws.bitmart.com/api?protocol=1.1
towss://openapi-ws-v2.bitmart.com/api?protocol=1.1
- Change the value of the variable FUTURES_PRIVATE_WS_URL
from
wss://openapi-ws.bitmart.com/user?protocol=1.1
towss://openapi-ws-v2.bitmart.com/user?protocol=1.1
- New
/contract/private/trade-fee-rate
Support querying trade fee rate(KEYED)
- Add API_V2_URL=
https://api-cloud-v2.bitmart.com
- The default URL of the client APIContract is changed to API_V2_URL
- Optimize websocket
- Remove
CloudWSClient
andCloudWSContractClient
- Remove
websockets
dependency - The ping/pong mechanism of the spot websocket has been modified to support
ping
text
- Remove
- New
/contract/private/submit-tp-sl-order
/contract/private/modify-plan-order
/contract/private/modify-preset-plan-order
/contract/private/modify-tp-sl-order
- Updated
/contract/private/cancel-order
Add new request field client_order_id/contract/private/cancel-plan-order
Add new request field client_order_id/contract/private/current-plan-order
Add new request field plan_type
- Update the dome of the README
- Fix the issue that the socket package cannot be referenced
- New
/spot/v4/batch_orders
/spot/v4/cancel_orders
/spot/v4/cancel_all
/contract/private/position-risk
/contract/private/current-plan-order
- Updated
/account/v1/withdraw/apply
/account/v2/deposit-withdraw/history
/contract/private/position
/contract/private/trades
/contract/private/submit-order
- Removed
/spot/v2/ticker
/spot/v1/ticker_detail
/spot/v1/steps
/spot/v1/symbols/kline
/spot/v1/symbols/book
/spot/v1/symbols/trades
/spot/v2/batch_orders
/spot/v1/cancel_orders
- Support Custom Logger Integration
- Support Custom request headers
- Dependency upgrade, websockets used are replaced with websocket-client
- Remove the asynchronous call mechanism and support customers’ more convenient custom asynchronous subscriptions.
- Log upgrade, replace print with logging
- Add examples directory
- Constants Renamed
- WS_URL renamed to SPOT_PUBLIC_WS_URL
- WS_URL_USER renamed to SPOT_PRIVATE_WS_URL
- CONTRACT_WS_URL renamed to FUTURES_PUBLIC_WS_URL
- CONTRACT_WS_URL_USER renamed to FUTURES_PRIVATE_WS_URL
- New endpoints for API Spot Market
/spot/quotation/v3/tickers
Get Ticker of All Pairs (V3)/spot/quotation/v3/ticker
Get Ticker of a Trading Pair(V3)/spot/quotation/v3/lite-klines
Get Latest K-Line (V3)/spot/quotation/v3/klines
Get History K-Line (V3)/spot/quotation/v3/books
Get Depth(V3)/spot/quotation/v3/trades
Get Recent Trades(V3)
- New endpoints for API Futures Trading
/contract/private/get-open-orders
Get All Open Orders (KEYED)/contract/private/submit-leverage
Submit Leverage (SIGNED)
- New endpoints for API Futures Trading
/account/v1/transfer-contract
Transfer between spot account and contract account/account/v1/transfer-contract-list
Query futures account transfer records
- New endpoints for Spot / Margin trading
/spot/v4/query/order
Query order by id (v4)/spot/v4/query/client-order
Query order by client order id (v4)/spot/v4/query/open-orders
Current open orders (v4)/spot/v4/query/history-orders
Account orders (v4)/spot/v4/query/trades Account
trade list (v4)/spot/v4/query/order-trades
Order trade list(v4)
- New endpoints for API Broker
/spot/v1/broker/rebate
Applicable to query API Broker's rebate records
- Update endpoints for Spot / Margin trading
/spot/v3/orders
/spot/v2/trades
add start_time and end_time field for flexible querying- add new order status 11 = Partially filled and canceled
- contract websocket public channel address
wss://openapi-ws.bitmart.com/api?protocol=1.1
- contract websocket private channel address
wss://openapi-ws.bitmart.com/user?protocol=1.1
- Upgrade endpoints for Spot
/spot/v1/ticker
has been upgraded to/spot/v2/ticker
and/spot/v1/ticker_detail
/spot/v1/submit_order
has been upgraded to/spot/v2/submit_order
/spot/v1/batch_orders
has been upgraded to/spot/v2/batch_orders
/spot/v2/cancel_order
has been upgraded to/spot/v3/cancel_order
/spot/v1/order_detail
has been upgraded to/spot/v2/order_detail
/spot/v2/orders
has been upgraded to/spot/v3/orders
/spot/v1/trades
has been upgraded to/spot/v2/trades
- New endpoints for Spot & Margin
/spot/v1/margin/isolated/account
Applicable for isolated margin account inquiries/spot/v1/margin/isolated/transfer
For fund transfers between a margin account and spot account/spot/v1/user_fee
For querying the base rate of the current user/spot/v1/trade_fee
For the actual fee rate of the trading pairs/spot/v1/margin/submit_order
Applicable for margin order placement/spot/v1/margin/isolated/borrow
Applicable to isolated margin account borrowing operations/spot/v1/margin/isolated/repay
Applicable to isolated margin account repayment operations/spot/v1/margin/isolated/borrow_record
Applicable to the inquiry of borrowing records of an isolated margin account/spot/v1/margin/isolated/repay_record
Applicable to the inquiry of repayment records of isolated margin account/spot/v1/margin/isolated/pairs
Applicable for checking the borrowing rate and borrowing amount of trading pairs
- New endpoints for Contract Market
/contract/public/details
Get contract details/contract/public/depth
Get contract depth/contract/public/open-interest
Get contract open interest/contract/public/funding-rate
Get contract funding rate/contract/public/kline
Get contract kline
- New endpoints for Contract Account
/contract/private/assets-detail
Get contract user assets detail
- New endpoints for Contract Trade
/contract/private/order
Get contract order detail/contract/private/order-history
Get contract order history/contract/private/position
Get contract position/contract/private/trades
Get contract trades/contract/private/submit_order
Post contract submit order/contract/private/cancel_order
Post contract cancel order/contract/private/cancel_orders
Post contract batch cancel orders
- Update endpoints for Spot
/spot/v1/symbols/details
Add a new respond parameter trade_status, to show the trading status of a trading pair symbol.
- websocket public channel address
wss://ws-manager-compress.bitmart.com?protocol=1.1
will be taken down on 2022-02-28 UTC time,The new address iswss://ws-manager-compress.bitmart.com/api?protocol=1.1
- New endpoints for Spot
/spot/v2/orders
Get User Order History V2/spot/v1/batch_orders
Batch Order
- Update endpoints for Spot
/spot/v1/symbols/kline
Add new field 'quote_volume'/spot/v1/symbols/trades
Add optional parameter N to return the number of items, the default is up to 50 items/spot/v1/order_detail
Add new field 'unfilled_volume'/spot/v1/submit_order
The request parameter type added limit_maker and ioc order types
- New endpoints for Account
/account/v2/deposit-withdraw/history
Get Deposit And Withdraw History V2
- Update endpoints for Account
/account/v1/wallet
Remove the account_type,Only respond to currency accounts; you can bring currency parameters (optional)
- Update endpoints for Spot WebSocket
- Public-Depth Channel:
- spot/depth20 20 Level Depth Channel
- spot/depth50 50 Level Depth Channel
- User-Trade Channel:
- Eligible pushes add new orders successfully
- Public-Depth Channel:
- New endpoints for Spot WebSocket
- Public - ticket channels
- Public - K channel
- Public - trading channels
- Public - depth channels
- Login
- User - Trading Channel
- Interface Spot API
/spot/v1/symbols/book
addsize
parameter, which represents the number of depths
- Interface Spot API
Cancel Order
update to v2 version that isPOST https://api-cloud.bitmart.com/spot/v2/cancel_order
- UserAgent set "BitMart-Python-SDK/1.0.1