OKX Updates the 'Get Fee Rates' API Interface

Dear OKX API users,

Following recent adjustments to the fee rate system, OKX has implemented changes to the 'Get fee rates' interface to streamline fee rate categories and enhance transparency. This update ensures consistency across all currency pairs while introducing clearer distinctions for futures and perpetual contracts based on margin types. These modifications will take effect on May 7, 2022.

Key Interface Changes

1. Removal of the 'Category' Field

Reason: All currency pairs now fall under a single fee rate category.
Impact: Existing API calls remain unaffected; responses will return identical data regardless of whether the category parameter is included.

2. New Return Parameters

takerU and makerU: Represent fee rates for USDT-margined futures and perpetual contracts.
Updated Meaning of taker/maker: Now exclusively reflect rates for crypto-margined contracts.

Technical Specifications

Endpoint Details

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`, etc.).
`instId`	String	No	Instrument ID (e.g., `BTC-USDT`).
`uly`	String	No	Underlying (e.g., `BTC-USD`).

Return Parameters

Parameter	Type	Description
`taker`	String	Taker fee rate (crypto-margined contracts).
`maker`	String	Maker fee rate (crypto-margined contracts).
`takerU`	String	Taker fee rate (USDT-margined contracts).
`makerU`	String	Maker fee rate (USDT-margined contracts).
`level`	String	Fee rate tier.
`ts`	String	Timestamp (Unix millisecond format).

Action Required

Review Strategies: Ensure compatibility with updated fee structures.
Update Systems: Integrate new parameters (takerU, makerU) where applicable.

👉 Explore OKX API documentation for advanced integration tips.

FAQ

Q1: Will historical API calls break after this update?

A: No. The category field removal is backward-compatible.

Q2: How do I identify USDT-margined vs. crypto-margined rates?

A: Use takerU/makerU for USDT rates; taker/maker for crypto rates.

Q3: Are spot trading fees affected?

A: No. Changes apply only to futures/perpetual contracts.

For further assistance, contact OKX support or refer to the official API documentation.