Skip to main content
GET
/
fee-rate
Get Fee Rate
curl --request GET \
  --url https://clob.kuest.com/fee-rate

Overview

This endpoint returns the base fee rate for a specified token. The fee rate is expressed in basis points (bps) and is applied to trades on the platform.

Request

Query Parameters

token_id
string
required
Token identifier to inspect. This is the unique identifier for the outcome token you want to query.

Request Example

curl "https://clob.kuest.com/fee-rate?token_id=0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0"
```bash

## Response

<ResponseField name="base_fee" type="integer" required>
  Base fee rate in basis points. For example, a value of 200 represents a 2% fee (200 basis points).
</ResponseField>

### Response Example

```json
{
  "base_fee": 200
}
```bash

## Understanding Fee Rates

Fee rates are expressed in basis points (bps):
- **1 basis point** = 0.01% = 0.0001
- **100 basis points** = 1%
- **200 basis points** = 2%

### Example Calculation

For a trade of 1000 USDC with a base_fee of 200 bps:
```bash
Fee = 1000 × (200 / 10000) = 1000 × 0.02 = 20 USDC
```bash

## Error Responses

### 400 Bad Request

Returned when the `token_id` parameter is missing or malformed.

```json
{
  "error": "missing_field: token_id"
}
```bash

### 404 Not Found

Returned when the specified token ID does not exist.

```json
{
  "error": "token_not_found"
}
```bash

## Use Cases

- Calculate expected trading fees before placing orders
- Display fee information to users
- Compare fee structures across different tokens
- Build fee calculators and trading cost estimators

Build docs developers (and LLMs) love