For Sub Portfolio API Key to query fee rates of current portfolio.
Permission
- Applies to Sub Portfolio API Key only
- Permission: READ.
Rate Limit
- to be confirmed
Request
| Field | Type | Mandatory | Remark |
|---|---|---|---|
| exchange | String | N | Exchange type, like BINANCE , OKX .. |
| instType | String | N | Business type, like SPOT, PERP ... |
Response
| Field | Type | Remark |
|---|---|---|
| portfolioId | String | ID of the sub-portfolio (or main portfolio) to which this fee configuration applies. |
| exchange | String | Exchange type, like BINANCE , OKX .. |
| instType | String | Business type, like SPOT, PERP ... |
| effDate | String | Effective date of this fee schedule, in yyyyMMdd format (e.g. 20251125). |
| maker | String | Deprecated. Kept only for backward compatibility. Actual maker fee should be read from groupList[ ].makerFee. |
| taker | String | Deprecated. Kept only for backward compatibility. Actual taker fee should be read from groupList[ ].takerFee. |
| level | String | Fee level / tier of the portfolio on this venue (e.g. T1, T2). |
| groupList | List | Symbol fee groups under this venue & instrument type.please see below |
*groupList： Regarding OKX's fee rate mechanism changes on Nov 25 , the Connex fee rate also make the corresponding changes on Nov 6pm GMT+8. Group information will contain the list of symbols belong to the fee group.
For forward compatibility， a default fee rate group of main coins have been selected to make sure the API usage will not impact the integration.
GroupVo Response
| Field | Type | Remark |
|---|---|---|
| groupName | String | Group name, e.g. A, B, C, D. |
| takerFee | String | Taker fee rate for this symbol group. |
| makerFee | String | Maker fee rate for this symbol group. |
| symList | list | List of symbols that belong to this group. |
Note
This endpoint returns the trading fee schedule configured for a broker’s sub-portfolio on each exchange and instrument type.
For the given sub-portfolio, it provides the effective date, fee tier level, and detailed symbol-level fee groups, including maker/taker fee rates per group.
Response will contain fee rates of two portfolios. One is for the current sub portfolio, and the other is for the main portfolio. by default, it is using the main portfolio fee rate. if set sub portfolio's fee rate, it used its own rate from effDate