Version 1.5.0 (21 July 2025)

Add ability to cancel all orders from a market for Delete Order (Remove mandatory from field description)

Version 1.4.9 (16 July 2025)

• [Spot] Release V3.3 API. This change will take effect on 16th July, 2025.
• [Futures] Release V2.3 API. This change will take effect on 16th July, 2025.

Version 1.4.8 (10 July 2025)

The platform will phase out support for two open API endpoints on 30th July, 2025. The following endpoints will be deprecated:

• Query available crypto network list for currency
• Query exchange rate between assets

Version 1.4.7 (09 April 2025)

Update the description for Request field type for Amend Order. This change will take effect on 18th May, 2025.

Version 1.4.6 (21 March 2025)

Add new wallet endpoint Get crypto networks

Version 1.4.5 (22 January 2025)

• [WebSocket] Add description for ping/pong mechanism.
• [WebSocket] Remove grouping argument from oss L1 orderbook snapshot and change description for push timing.

Version 1.4.4 (21 January 2025)

Add Futures 2.2 api documentation

Version 1.4.3 (18 September 2024)

Update the permission-related content in the description of all APIs

Version 1.4.2 (12 September 2024)

[Fix] Support unified wallet isolated position

Version 1.4.1 (21 August 2024)

Description of the Index Order only supports USD quotes. Create new order

Version 1.4.0 (14 August 2024)

[WebSocket] Send an additional cancel notification for an IOC order which is partially filled.

Version 1.3.9 (08 August 2024)

Add new wallet endpoint Delete Wallet Address to delete an address

Version 1.3.8 (26 July 2024)

• Change description for closeOrder of all position models
• [WebSocket] Add a behaviour to push positionsV2 and allPositionsV3 every 5 seconds

Version 1.3.7 (21 June 2024)

Remove WebSocket topics trades which is replaced by tradeHistoryApi (spot) and tradeHistoryApiV2 (futures)

Version 1.3.6 (20 June 2024)

Add new version of WebSocket topics to apply new market name.

• change tradeHistoryApi to tradeHistoryApiV2
• change fills to fillsV2
• change notificationApiV2 to notificationApiV3
• change allPosition to allPositionV3
• change positions to positionsV2

Version 1.3.5 (29 May 2024)

Add contractSize field in the following APIs and WebSocket topics.

• Query Trade History
• Query Order
• Query Open Orders
• Query Position
• fills
• allPosition
• positions

Version 1.3.4 (03 April 2024)

Add API for querying Subaccount Transfer History

Version 1.3.3 (29 March 2024)

Description of the maximum number of days for querying historical records.

• [Spot] Query Trades Fills
• [Futures] Query Trades Fills / Query Wallet History

Version 1.3.2 (22 February 2024)

[Futures] Spam order rule adjustment

[WS] add OSS-L1-Snapshot for Futures Orderbook Streaming

Version 1.3.1 (02 February 2024)

[Spot] Add wallet currency description for B_, M_, K_ prefixed markets for Wallet Balance and Wallet History

Version 1.3.0 (01 February 2024)

[Futures] Add contract size and notional value description for futures order api

Version 1.2.9 (31 January 2024)

[Futures] Add API for querying Funding History

Version 1.2.8 (29 January 2024)

[Futures] Support Cross Leverage

• Add marginMode field in api Get Leverage and Set Leverage

Version 1.2.7 (05 January 2024)

Change description for walletSrc and walletDest for Wallet Transfer and Sub-account Wallet Transfer which is required only for related walletSrcType and walletDestType is ISOLATED

Version 1.2.6 (15 November 2023)

[FIX] Add new timeInForce status

Version 1.2.5 (08 November 2023)

• Add API Query Position Mode and Change Position Mode for querying and changing position mode
• API related to order and position have added the fields or parameter: positionMode and positionId and positionDirection

Version 1.2.4 (07 November 2023)

• Update fundingRate description in Market Summary
• Add listFullAttributes parameter in Market Summary
• Add optional fundingIntervalMinutes and fundingTime in Market Summary
• The new funding rate interval scheduled effective date is Nov 14, 2023
• Add new API Query Order

Version 1.2.3 (31 October 2023)

[IMPORTANT] Futures: Adjust the HTTP status code (200) and error messages for trading-related API. The scheduled effective date is November 7, 2023, at 10:00 AM (UTC+0).
This includes but is not limited to the following situations.

• Order not found
  • Change status code to 400
  • Change errorCode to 400
• Order rejected
  • Change status code to 400
  • Change errorCode to 400
• Maximum open order exceeded
  • Change status code to 400
  • Change errorCode to 304
• reach rate limit
  • Change status code to 429
  • Change errorCode to 303
• market unavailable
  • Change status code to 400
  • Change errorCode to 400

Version 1.2.2 (23 October 2023)

[Futures] Add positions in websocket streams for user to get all positions includes closed position

Version 1.2.1 (20 October 2023)

[Spot] Add two new response field isMarketOpenToOtc, isMarketOpenToSpot in Market Summary

Version 1.2.0 (16 October 2023)

[Futures]

• Add TP/SL (Take Profit/Stop Loss) parameters in Create New Order
• Add API Bind TP/SL in Trade Endpoints to bind TP/SL with an existing position
• Add TP/SL fields in Trade Endpoints Query Open Orders and Query Positions
• Add TP/SL fields in Websocket Streams All Position

Version 1.1.9 (03 October 2023)

[Futures] Correct response data type

Version 1.1.8 (18 September 2023)

[Spot] Correct the data types of parameters in order related APIs and remove 451 status code

Version 1.1.7 (11 September 2023)

[Futures] Add Get Leverage to get leverage for market

Version 1.1.6 (03 September 2023)

Remove the slide parameter from Amend Order

Version 1.1.5 (29 August 2023)

Add status code 400 for abnormal usage.

Version 1.1.4 (24 August 2023)

Deprecate legacy orderbook for spot and futures, please use oss orderbook stream instead.

Version 1.1.3 (17 July 2023)

Add new websocket topic Futures Open Order

Version 1.1.2 (10 July 2023)

[FIX] Apply new symbol name in Futures market. Add ApplyNewSymbolName in Logon message

Version 1.1.1 (10 July 2023)

Add heartbeat recommondation

Version 1.1.0 (12 April 2023)

Deprecated two websokcet topics Orderbook Snapshot (By grouping) and Orderbook Snapshot (By depth) today.
Please use the following websokcet topics through the endpoint wss://ws.lmex.io/ws/oss/spot to get orderbook data.

• Orderbook Incremental Updates
• OSS L1 Snapshot (By grouping)

Version 1.0.9 (06 April 2023)

Add websocket topic: OSS L1 Snapshot (By grouping)

Version 1.0.8 (27 March 2023)

Add missing error code description

Version 1.0.7 (21 March 2023)

Update the http status code for authentication failed to `401`

Version 1.0.6 (02 March 2023)

The following changes are only for documentation:

• Remove mistype token header and should not be used, we use request-api, request-nonce and request-sign as header parameters for authentication.
• Add examples for signature generating of authentication, include GET and POST resources.
• Update symbol name of websocket response example.
• Color and layout adjustment.

Version 1.0.5 (11 January 2023)

• Spot/Futures add <>Public Trade Fills 2 for new Websocket topic trades to have unique key support to get trade history by market.

Version 1.0.4 (05 January 2023)

• Release Spot and Futures market trading functions FIX API

Version 1.0.3 (01 December 2022)

• Rename Spot/Futures OSS section to Spot/Futures Orderbook Streaming for Websocket.

Version 1.0.2 (16 November 2022)

[IMPORTANT] LMEX will change futures market naming convention in December 2022 to provide more clarity to retail users and here are the rules:

1. Change the suffix for perpetual markets from PFC to PERP (ex: BTCPFC -> BTC-PERP)
2. Change the suffix for time-based markets from delivery month + year to settlement date (YYMMDD) (ex: BTCZ22 -> BTC-221230)
3. Added a new optional query parameter useNewSymbolNaming in Query Wallet History and Transfer Funds if user wants to use new market name
4. Futures API updated (Generally added a new optional parameter useNewSymbolNaming to specify if the market name is in the new format):
   • Market Summary
   • Query Open Orders
   • Orderbook by grouping
   • Orderbook
   • Charting Data
   • Query Wallet History
   • Query Wallet Balance
   • Set Leverage
   • Set Risk Limit
   • Query Market Price
   • Change Contract Settlement Currency
   • Query Account Fee
   • Query Position
   • Close Position
   • Query Wallet Margin
   • Create New Order
   • Query Trades Fills
5. Existing websocket topics will return data with the current market name (ex: BTCPFC) and new set of websocket topics are added for new market name (ex: BTC-PERP) where the response fields will be the same and here's the mapping table
   • tradeHistoryApi -> tradeHistoryApiV2
   • orderbookApi -> orderbookApiV2
   • orderbookL2Api -> orderbookL2ApiV2
   • fills -> fillsV2
   • allPosition -> allPositionV2
   • notificationApiV2 -> notificationApiV3

Version 1.0.1 (27 October 2022)

• Add new resopnse property originalPrice to Amend Order.

Version 1.0.0

Initial version