Skip to main content
POST
/
spreads
Calculate Bid/Ask Spreads
curl --request POST \
  --url https://clob.kuest.com/spreads \
  --header 'Content-Type: application/json' \
  --data '
{
  "token_id": "<string>"
}
'

​
Overview

This endpoint calculates the bid/ask spread for one or more tokens. The spread represents the difference between the best bid and best ask prices, indicating market liquidity.

​
Request

​
Body Parameters

The request body should be a JSON array of spread request objects:
​
token_id
string
required
Token identifier to calculate the spread for. This is the unique identifier for the outcome token.

​
Request Example

curl -X POST https://clob.kuest.com/spreads \
  -H "Content-Type: application/json" \
  -d '[
    {
      "token_id": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0"
    },
    {
      "token_id": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:1"
    }
  ]'
```bash

## Response

Returns an object mapping token IDs to their respective spreads.

<ResponseField name="[token_id]" type="string">
  The bid/ask spread for the specified token, expressed as a decimal string. The key is the token ID from the request.
</ResponseField>

### Response Example

```json
{
  "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0": "0.05",
  "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:1": "0.05"
}
```bash

## Understanding Spreads

The spread value indicates:
- **Lower spread** (e.g., 0.01-0.05): High liquidity, tight market
- **Higher spread** (e.g., 0.10+): Lower liquidity, wider market
- A spread of 0 indicates no active orders on one or both sides

## Use Cases

- Assess market liquidity before placing orders
- Compare trading costs across different markets
- Monitor market health and trading conditions
- Optimize order placement strategies