- New
/account/v1/get-deposit-accountGet Deposit Account (KEYED)/account/v1/set-deposit-accountSet Deposit Account (SIGNED)/account/v1/transferAccount Transfer (SIGNED)/uapi-key/v1/account/infoGet Account Info (KEYED)/contract/private/close-all-positionClose All Positions (SIGNED)/contract/private/account/v1/transferContract Account Transfer (SIGNED)
- Update
/account/v1/withdraw/applyWithdraw (SIGNED): Add new request field sourceAccount
- New
/newearn/cloud/v1/earnGet Savings (Earn) Account Holdings (KEYED)/newearn/cloud/v1/saving/productGet Flexible Savings Product List (KEYED)/newearn/cloud/v1/saving/subscribeSubscribe Flexible Savings (SIGNED)/newearn/cloud/v1/saving/redeemRedeem Flexible Savings (SIGNED)/newearn/cloud/v1/saving/earnGet Flexible Savings Holdings (KEYED)/newearn/cloud/v1/saving/recordGet Flexible Savings Records (KEYED)/newearn/cloud/v1/saving/fixed/productGet Fixed Savings Product List (KEYED)/newearn/cloud/v1/saving/fixed/subscribeSubscribe Fixed Savings (SIGNED)/newearn/cloud/v1/saving/fixed/earnGet Fixed Savings Holdings (KEYED)/newearn/cloud/v1/saving/fixed/recordGet Fixed Savings Records (KEYED)/newearn/cloud/v1/saving/fixed/redeemEarly-Redeem Fixed Savings (SIGNED)/newearn/cloud/v1/saving/fixed/subscribe/operateModify Fixed Savings Auto-Renewal (SIGNED)/newearn/cloud/v1/saving/subscribe/batch/operateToggle Global Auto-Earn (SIGNED)/newearn/cloud/v1/saving/subscribe/batchGet Global Auto-Earn Status (KEYED)/newearn/cloud/v1/saving/subscribe/operateToggle Flexible Product Auto-Subscribe (SIGNED)/newearn/cloud/v1/saving/subscribe/statusGet Flexible Product Auto-Subscribe Status (KEYED)
- New
/account/sub-account/main/v1/sub-to-mainSub-Account to Main-Account (For Main Account) (SIGNED)/account/sub-account/sub/v1/sub-to-mainSub-Account to Main-Account (For Sub-Account) (SIGNED)/account/sub-account/main/v1/main-to-subMain-Account to Sub-Account (For Main Account) (SIGNED)/account/sub-account/main/v1/sub-to-subSub-Account to Sub-Account (For Main Account) (SIGNED)/account/sub-account/main/v1/transfer-listGet Sub-Transfer History (For Main Account) (KEYED)/account/sub-account/v1/transfer-historyGet Account Transfer History (For Main and Sub Account) (KEYED)/account/sub-account/main/v1/walletGet Sub-Account Spot Wallet Balance (For Main Account) (KEYED)/account/sub-account/main/v1/subaccount-listGet Sub-Account List (For Main Account) (KEYED)/account/contract/sub-account/main/v1/sub-to-mainContract Sub-Account to Main-Account (For Main Account) (SIGNED)/account/contract/sub-account/main/v1/main-to-subContract Main-Account to Sub-Account (For Main Account) (SIGNED)/account/contract/sub-account/sub/v1/sub-to-mainContract Sub-Account to Main-Account (For Sub-Account) (SIGNED)/account/contract/sub-account/main/v1/walletGet Contract Sub-Account Wallet Balance (For Main Account) (KEYED)/account/contract/sub-account/main/v1/transfer-listGet Contract Sub-Transfer History (For Main Account) (KEYED)/account/contract/sub-account/v1/transfer-historyGet Contract Account Transfer History (For Main and Sub Account) (KEYED)
- New
/spot/v4/algo/submit_orderSubmit Algo Order(v4) (SIGNED)/spot/v4/algo/cancel_orderCancel Algo Order(v4) (SIGNED)/spot/v4/algo/cancel_allCancel All Algo Orders(v4) (SIGNED)/spot/v4/query/algo/orderQuery Algo Order by orderId(v4) (SIGNED)/spot/v4/query/algo/client-orderQuery Algo Order by clientOrderId(v4) (SIGNED)/spot/v4/query/algo/open-ordersQuery Algo Current Orders(v4) (SIGNED)/spot/v4/query/algo/history-ordersQuery Algo History Orders(v4) (SIGNED)/contract/public/funding-rate-v2Get Current Funding Rate V2/contract/private/auto_repaymentQuery Auto Repayment Records (KEYED)/contract/private/cross_collateral/interest_logQuery Interest Accrual Log (KEYED)/contract/private/claimClaim Demo Assets (SIGNED)/contract/private/affiliate/rebate-inviteUserQuery Invited Users Rebate (KEYED)/contract/private/affiliate/invite-checkCheck Invited User (KEYED)/contract/private/affiliate/rebate-userQuery Single User Rebate (KEYED)/contract/private/affiliate/rebate-apiQuery Single API User Rebate (KEYED)/contract/private/affiliate/deposit-withdrawal-listQuery Invited Users Deposit And Withdraw (KEYED)/contract/private/affiliate/aff-customer-infoQuery Invited User Contract Account Info (KEYED)/contract/private/affiliate/rebate-listQuery Rebate Records (KEYED)/contract/private/affiliate/trade-listQuery Invited Users Trade Records (KEYED)spot/bookTicker:{symbol}[WebSocket] New public Best Order (bookTicker) channel
- Update
/contract/private/tradesGet Order Trade (KEYED): Add new request field order_id, client_order_id
- New
/contract/private/modify-limit-orderModify Limit Orders(SIGNED)/contract/private/cancel-all-afterTimed Cancel All Orders (SIGNED)/contract/private/set-position-modeSet Position Mode (SIGNED)/contract/private/get-position-modeGet Position Mode (KEYED)/contract/private/position-v2Get Current Position V2 (KEYED)/contract/public/leverage-bracketGet Current Leverage Risk Limit/contract/public/market-tradeQuery the latest trade data/contract/public/markprice-klineGet MarkPrice K-line/account/v1/withdraw/address/listQuery Withdraw Address List (KEYED)
- Update
/contract/private/submit-orderSubmit Order(SIGNED): Add new request field stp_mode/contract/private/orderGet Order Detail (KEYED): Add new request field account/contract/private/order-historyGet Order History (KEYED): Add new request field account, order_id, client_order_id/contract/private/positionGet Current Position (KEYED): Add new request field account/contract/private/position-riskGet Current Position Risk Details(KEYED): Add new request field account/contract/private/tradesGet Order Trade (KEYED): Add new request field account/contract/private/transaction-historyGet Transaction History (KEYED): Add new request field account/contract/private/tradesGet Order Trade: Request field symbol changed to optional/account/v1/currenciesGet Currencies/account/v2/deposit-withdraw/historyGet Deposit And Withdraw History (KEYED)/spot/v2/submit_orderNew Order(v2) (SIGNED): Add new request parameter field stpMode/spot/v4/batch_ordersNew Batch Order(v4) (SIGNED): Add new request parameter field stpMode
- Upgrade commons-lang3 to version 3.18.0
- Upgrade commons-codec to version 1.16.0
- New
/contract/private/submit-trail-orderSubmit Trail Order (SIGNED)/contract/private/cancel-trail-orderCancel Trail Order (SIGNED)/contract/public/funding-rate-historyQuery Funding Rate History/contract/public/transaction-historyQuery Transaction History (KEYED)
- Update
/contract/private/submit-orderSubmit Order (SIGNED): Remove the Request Parameters related replacing trail orders/contract/private/modify-plan-orderModify Plan Order (SIGNED): Remove the Request Parameters client_order_id
- The domain name
wss://openapi-ws.bitmart.comwill not provide Futures 1.0 Websocket services. Please use the domain name wss://openapi-ws-v2.bitmart.com to access Futures 2.0 Websocket services - Rename
GlobalConst.CLOUD_WS_URLtoGlobalConst.CLOUD_SPOT_WS_PUBLIC_URL - Rename
GlobalConst.CLOUD_WS_PRIVATE_URLtoGlobalConst.CLOUD_SPOT_WS_PRIVATE_URL - Rename
GlobalConst.CLOUD_CONTRACT_WS_URLtoGlobalConst.CLOUD_FUTURES_WS_PUBLIC_URLand change the value from wss://openapi-ws.bitmart.com/api?protocol=1.1 to wss://openapi-ws-v2.bitmart.com/api?protocol=1.1 - Rename
GlobalConst.CLOUD_CONTRACT_WS_PRIVATE_URLtoGlobalConst.CLOUD_FUTURES_WS_PRIVATE_URLand change the value from wss://openapi-ws.bitmart.com/user?protocol=1.1 to wss://openapi-ws-v2.bitmart.com/user?protocol=1.1 - Upgrading dependencies with vulnerabilities
- remove org.bouncycastle:bcprov-jdk15on:1.70
- New
/contract/private/trade-fee-rateSupport querying trade fee rate(KEYED)
- Add GlobalConst.CLOUD_V2_URL=
https://api-cloud-v2.bitmart.com - Optimize websocket
- The ping/pong mechanism of the spot websocket has been modified to support
pingtext - The
sendfunction replaces thesubscribefunction and can be used to subscribe and unsubscribe - Remove the
isDebugfunction andisPrintvariable, and use thelog levelto set debug instead
- The ping/pong mechanism of the spot websocket has been modified to support
- Upgrading dependencies with vulnerabilities
- com.squareup.okhttp3 has been upgraded to 4.11.0
- io.netty has been upgraded to 4.1.114.Final
- org.bouncycastle has been upgraded to 1.70
- ch.qos.logback has been upgraded to 1.2.13
- 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-orderAdd new request field client_order_id/contract/private/cancel-plan-orderAdd new request field client_order_id/contract/private/current-plan-orderAdd new request field plan_type
- Updated examples in the readme file
- The post request does not carry the request header
X-BM-KEY
- New
/spot/v4/batch_orders/spot/v4/cancel_orders/spot/v4/cancel_all/contract/private/get-open-orders/contract/private/current-plan-order/contract/private/position-risk
- Updated
/account/v1/withdraw/apply/contract/private/submit-order/contract/private/submit-plan-order
- Removed
/spot/v1/steps/spot/v1/symbols/book/spot/v1/symbols/kline/spot/v1/symbols/trades/spot/v1/ticker_detail/spot/v2/ticker/spot/v2/batch_orders/spot/v1/cancel_orders/spot/v2/trades/spot/v2/order_detail/spot/v3/orders
- Support custom request headers
- Class Renaming
- OrderRequest renamed to GetOrderDetailRequest
- OrderHistoryRequest renamed to GetOrderHistoryRequest
- PositionRequest renamed to GetPositionRequest
- Fix the exception caused by returning compressed data when logging into spot WebSocket
- New endpoints for API Spot Market
/spot/quotation/v3/tickersGet Ticker of All Pairs (V3)/spot/quotation/v3/tickerGet Ticker of a Trading Pair(V3)/spot/quotation/v3/lite-klinesGet Latest K-Line (V3)/spot/quotation/v3/klinesGet History K-Line (V3)/spot/quotation/v3/booksGet Depth(V3)/spot/quotation/v3/tradesGet Recent Trades(V3)
- New endpoints for API Futures Trading
/contract/private/submit-plan-orderSubmit Plan Order (SIGNED)/contract/private/cancel-plan-orderCancel Plan Order (SIGNED)/contract/private/submit-leverageSubmit Leverage (SIGNED)
- New endpoints for API Futures Trading
/account/v1/transfer-contractTransfer between spot account and contract account/account/v1/transfer-contract-listQuery futures account transfer records
- New endpoints for Spot / Margin trading
/spot/v4/query/orderQuery order by id (v4)/spot/v4/query/client-orderQuery order by client order id (v4)/spot/v4/query/open-ordersCurrent open orders (v4)/spot/v4/query/history-ordersAccount orders (v4)/spot/v4/query/trades Accounttrade list (v4)/spot/v4/query/order-tradesOrder trade list(v4)
- New endpoints for API Broker
/spot/v1/broker/rebateApplicable to query API Broker's rebate records
- Update endpoints for Spot / Margin trading
/spot/v3/orders/spot/v2/tradesadd start_time and end_time field for flexible querying- add new order status 11 = Partially filled and canceled
- Upgrade endpoints for Spot
/spot/v1/tickerhas been upgraded to/spot/v2/tickerand/spot/v1/ticker_detail/spot/v1/submit_orderhas been upgraded to/spot/v2/submit_order/spot/v1/batch_ordershas been upgraded to/spot/v2/batch_orders/spot/v2/cancel_orderhas been upgraded to/spot/v3/cancel_order/spot/v1/order_detailhas been upgraded to/spot/v2/order_detail/spot/v2/ordershas been upgraded to/spot/v3/orders/spot/v1/tradeshas been upgraded to/spot/v2/trades
- New endpoints for Spot & Margin
/spot/v1/margin/isolated/accountApplicable for isolated margin account inquiries/spot/v1/margin/isolated/transferFor fund transfers between a margin account and spot account/spot/v1/user_feeFor querying the base rate of the current user/spot/v1/trade_feeFor the actual fee rate of the trading pairs/spot/v1/margin/submit_orderApplicable for margin order placement/spot/v1/margin/isolated/borrowApplicable to isolated margin account borrowing operations/spot/v1/margin/isolated/repayApplicable to isolated margin account repayment operations/spot/v1/margin/isolated/borrow_recordApplicable to the inquiry of borrowing records of an isolated margin account/spot/v1/margin/isolated/repay_recordApplicable to the inquiry of repayment records of isolated margin account/spot/v1/margin/isolated/pairsApplicable for checking the borrowing rate and borrowing amount of trading pairs
- 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
- New endpoints for Contract Market
/contract/public/detailsGet contract details/contract/public/depthGet contract depth/contract/public/open-interestGet contract open interest/contract/public/funding-rateGet contract funding rate/contract/public/klineGet contract kline
- New endpoints for Contract Account
/contract/private/assets-detailGet contract user assets detail
- New endpoints for Contract Trade
/contract/private/orderGet contract order detail/contract/private/order-historyGet contract order history/contract/private/positionGet contract position/contract/private/tradesGet contract trades/contract/private/submit_orderPost contract submit order/contract/private/cancel_orderPost contract cancel order/contract/private/cancel_ordersPost contract batch cancel orders
- Update endpoints for Spot
/spot/v1/symbols/detailsAdd 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.1will 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/ordersGet User Order History V2/spot/v1/batch_ordersBatch Order
- Update endpoints for Spot
/spot/v1/symbols/klineAdd new field 'quote_volume'/spot/v1/symbols/tradesAdd optional parameter N to return the number of items, the default is up to 50 items/spot/v1/order_detailAdd new field 'unfilled_volume'/spot/v1/submit_orderThe request parameter type added limit_maker and ioc order types
- New endpoints for Account
/account/v2/deposit-withdraw/historyGet Deposit And Withdraw History V2
- Update endpoints for Account
/account/v1/walletRemove the account_type,Only respond to currency accounts; you can bring currency parameters (optional)
- Update endpoints for Spot WebSocket
- Public-Depth Channel:
- spot/depth50 50 Level Depth Channel
- spot/depth100 100 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/bookaddsizeparameter, which represents the number of depths
- Interface Spot API
Cancel Orderupdate to v2 version that isPOST https://api-cloud.bitmart.com/spot/v2/cancel_order - UserAgent set "BitMart-Java-SDK/1.0.1"
- Update endpoints for Spot
/spot/v1/symbols/detailsAdd 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.1will 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/ordersGet User Order History V2/spot/v1/batch_ordersBatch Order
- Update endpoints for Spot
/spot/v1/symbols/klineAdd new field 'quote_volume'/spot/v1/symbols/tradesAdd optional parameter N to return the number of items, the default is up to 50 items/spot/v1/order_detailAdd new field 'unfilled_volume'/spot/v1/submit_orderThe request parameter type added limit_maker and ioc order types
- New endpoints for Account
/account/v2/deposit-withdraw/historyGet Deposit And Withdraw History V2
- Update endpoints for Account
/account/v1/walletRemove the account_type,Only respond to currency accounts; you can bring currency parameters (optional)
- Update endpoints for Spot WebSocket
- Public-Depth Channel:
- spot/depth50 50 Level Depth Channel
- spot/depth100 100 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/bookaddsizeparameter, which represents the number of depths
- Interface Spot API
Cancel Orderupdate to v2 version that isPOST https://api-cloud.bitmart.com/spot/v2/cancel_order - UserAgent set "BitMart-Java-SDK/1.0.1"