For Master API Key to query fee rates of portfolios.
Permission
- Applies to primary user's API Key only
- Permission: READ.
Rate Limit
- to be confirmed
Request
| Field | Type | Mandatory | Remark |
|---|---|---|---|
| exchange | String | N | Exchange type, like BINANCE , OKX . If empty, returns fee schedules for all supported exchanges for the given portfolio scope. |
| instType | String | N | Instrument type, e.g. SPOT, PERP . If empty, returns all instrument types. |
| portfolioIds | String | N | Multiple portfolio IDs, comma-separated (e.g. "1001,1002,1003"). Up to 20 portfolio IDs are supported. If set, the API returns the fee schedule for this set of portfolios. |
| portfolioId | String | N | Single portfolio ID. If set (and portfolios is empty), the API returns the fee schedule for this portfolio plus the main account. |
Response
| Field | Type | Remark |
|---|---|---|
| portfolioId | String | Portfolio ID 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 with legacy responses. Actual maker fee should be read from groupList[].makerFee. |
| taker | String | Deprecated. Kept only for backward compatibility with legacy responses. Actual taker fee should be read from groupList[].takerFee. |
| level | String | Fee level / tier of the portfolio on this venue. |
| 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 current trading fee schedule for a specific broker portfolio on each exchange and instrument type.
For every venue/market it provides the default maker/taker fee rates, effective date, fee level, and optional symbol groups with customized fees.
If no portfolioId or portfolioIds is provided, the API returns the fee schedule of the main portfolio.
If a single portfolioId is provided, the API returns the combined fee schedule of that portfolioId and the main portfolio.
If multiple portfolioIds are provided (comma-separated, up to 20 IDs), the API returns the fee schedule for this set of portfolios.