OKX Will Make Changes to the 'Get Fee Rates' Interface

Published on 15 Apr 20222 min read
Dear OKX API users,

After the fee rate adjustment (For details, please refer to OKX Will Upgrade the Fee Rate System), all currency pairs will be in the same fee rate category. Futures and perpetual contracts will have different fee rates depending on whether they are USDT-margined or crypto-margined. The following adjustments will be made to Live Trading on May 7, 2022.

The following changes will be made to the 'Get fee rates' interface.
  1. The 'category' field will be removed, but it will not affect the existing program calls. A request returns the same data with or without the category value. This is because all currency pairs will be in the same fee rate category.
  2. Newly added return parameters: takerU and makerU, representing the fee rates of USDT-margined futures and perpetual contracts. When users check the fee rates of futures and perpetual contracts, the meaning of the original taker and maker parameters will change, representing only the fee rates of crypto-margined contracts. This is because futures and perpetual contracts will have different fee rates depending on whether they are USDT-margined or crypto-margined.

The interface path remains unchanged. Request parameters and return parameters after the adjustment are as follows.

Endpoint name: 'Get fee rates'

HTTP request
GET /api/v5/account/trade-fee

Request Parameters

Parameter Type Required Description
instType String Yes Instrument type
SPOT
MARGIN
SWAP
FUTURES
OPTION
instId String Optional Instrument ID, e.g. BTC-USDT
only applicable to SPOT/MARGIN
uly String Optional Underlying, e.g. BTC-USD
only applicable to FUTURES/SWAP/OPTION
category String Optional This field will be removed

Return Parameters

Parameter Type Description
category String Fee Schedule
taker String Taker fee rate for crypto-margined futures and perpetual contracts
maker String Maker fee rate for crypto-margined futures and perpetual contracts
takerU String TakerU fee rate, only applicable to futures and perpetual contracts
makerU String MakerU fee rate, only applicable to futures and perpetual contracts
delivery String Delivery fee rate
exercise String Fee rate for exercising the option
level String Fee rate Level
instType String Instrument type
ts String Data return time, Unix timestamp format in milliseconds, e.g. 1597026383085

Please carefully assess potential impacts and make sure that you're using the latest trading system to avoid any issues with strategy trading.

OKX
Apr. 15th, 2022 (UTC)