OKX Announces Updates to the 'Get Fee Rates' API Interface

Dear OKX API Users,

Following the recent fee rate adjustments (OKX Fee Rate System Upgrade), we're implementing changes to the Live Trading platform effective May 7, 2022. These updates streamline fee structures across all currency pairs while introducing new parameters for clearer rate differentiation.

Key Interface Changes

1. Structural Simplification

Removed field: The category parameter will be deprecated
No functional impact: Existing API calls will continue working normally
Rationale: All currency pairs now fall under a unified fee category

2. Enhanced Rate Transparency

New parameters:
- takerU: USDT-margined contracts taker fee
- makerU: USDT-margined contracts maker fee
Parameter behavior change:
- Original taker/maker now exclusively represent crypto-margined rates
- Futures/perpetuals display separate rates for USDT vs. crypto margining

👉 Explore OKX's updated fee structure

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	SPOT, MARGIN, SWAP, FUTURES, OPTION
instId	String	No	Instrument ID (BTC-USDT)
uly	String	No	Underlying (BTC-USD)

Response Parameters

Parameter	Type	Description
taker	String	Crypto-margined taker rate
maker	String	Crypto-margined maker rate
takerU	String	USDT-margined taker rate (new)
makerU	String	USDT-margined maker rate (new)
delivery	String	Delivery fee rate
exercise	String	Option exercise fee
level	String	Fee tier level
instType	String	Instrument type
ts	String	Timestamp (Unix milliseconds)

Implementation Recommendations

Test environments first: Validate all trading strategies with the new parameters
Update documentation: Reference the new takerU/makerU fields
Monitor rate differences: Note the separation between USDT and crypto rates

👉 Need API support? Contact OKX developers

FAQ Section

Q: Will existing API calls break after this change?
A: No, all current calls will remain functional. The category parameter will simply be ignored.

Q: How do I identify USDT-margined rates now?
A: Use the new takerU and makerU fields specifically for USDT-margined contracts.

Q: Are spot trading fees affected?
A: No, these changes primarily impact futures and perpetual contracts.

Q: When should we complete the migration?
A: We recommend updating your systems before May 7, 2022 to ensure seamless transition.

Q: Where can I find examples of the new response format?
A: Check our updated API documentation for sample responses including the new fields.

Important Notes

These changes reflect OKX's commitment to transparent fee structures
All developers should review their fee calculation logic