Dear OKX API Users,
Following the recent fee rate adjustments (part of OKX's broader fee system upgrade), we're implementing changes to the 'Get fee rates' interface to streamline your trading experience. These updates will go live on May 7, 2022.
Key Interface Changes
Category Field Removal
- The 'category' field will be deprecated as all currency pairs now fall under the same fee rate category
- Existing API calls remain unaffected (responses will be identical whether you include the category parameter or not)
New Return Parameters
takerUandmakerU: Represent fee rates for USDT-margined futures and perpetual contracts- Existing
takerandmakerparameters will now exclusively represent crypto-margined contract rates
👉 Learn more about OKX's trading fee structure
Updated API Specifications
Endpoint Details
- Name: Get fee rates
- HTTP Request:
GET /api/v5/account/trade-fee - Path: Unchanged
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| instType | String | Yes | Instrument type (SPOT/MARGIN/SWAP/FUTURES/OPTION) |
| instId | String | No | Instrument ID (e.g. BTC-USDT) - SPOT/MARGIN only |
| uly | String | No | Underlying (e.g. BTC-USD) - FUTURES/SWAP/OPTION only |
Response Structure
| Parameter | Type | Description |
|---|---|---|
| taker | String | Taker fee rate (crypto-margined contracts only) |
| maker | String | Maker fee rate (crypto-margined contracts only) |
| takerU | String | Taker fee rate for USDT-margined futures/perpetuals (new parameter) |
| makerU | String | Maker fee rate for USDT-margined futures/perpetuals (new parameter) |
| delivery | String | Delivery fee rate |
| exercise | String | Option exercise fee rate |
| level | String | Fee rate level |
| instType | String | Instrument type |
| ts | String | Timestamp (Unix epoch in milliseconds) |
Implementation Recommendations
- System Compatibility Check
Verify your trading systems can interpret the new response structure, particularly the differentiated rates for crypto vs. USDT margining. - Strategy Updates
Account for potential fee calculation changes in automated trading strategies, especially those involving futures/perpetuals.
👉 Explore OKX's API documentation for developers
FAQ Section
Q: Will existing API integrations break after this update?
A: No - all changes are backward compatible. The 'category' parameter will be ignored rather than causing errors.
Q: How do I identify USDT-margined vs. crypto-margined contract fees?
A: Use the new takerU/makerU fields for USDT rates; original taker/maker fields now represent crypto rates only.
Q: Are spot trading fees affected by these changes?
A: No - spot fees remain unchanged. These updates primarily impact derivatives trading.
Q: When should I update my integration?
A: We recommend testing the new response format before May 7 to ensure smooth transition.
OKX remains committed to providing transparent, competitive fee structures while maintaining API stability for our developer community. Always refer to our official documentation for the latest interface specifications.