Query Spread Tables
Endpoint Information
Endpoint: GET /market/v1/{market}/spread-tables
Description: Query each market's tick size tiers — the price ranges and their corresponding minimum spread (tick size)
Authentication: Institution API Key + Signature (non-Maker API endpoint — X-Maker-Addr is not required). See Authorization
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| market | ENUM | Yes | Market code (path parameter). See Market enum type description |
Response Parameters
| Field | Type | Description |
|---|---|---|
| code | STRING | Spread table code |
| price_bands | OBJECT[] | Price bands list |
price_bands Object
| Field | Type | Description |
|---|---|---|
| from | DECIMAL | Starting price |
| to | DECIMAL | Ending price |
| minimum_spread | DECIMAL | Minimum spread value within this price band |
Request Example
bash
curl -X GET "{API_BASE_URL}/market/v1/usex/spread-tables" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Timestamp: 1746774142000" \
-H "X-API-Signature: GENERATED_SIGNATURE"Response Example
json
{
"code": 0,
"data": [
{
"code": "01",
"price_bands": [
{
"from": 0.01,
"to": 0.25,
"minimum_spread": 0.001
},
{
"from": 0.25,
"to": 0.5,
"minimum_spread": 0.005
}
]
},
{
"code": "03",
"price_bands": [
{
"from": 0.5,
"to": 9999.95,
"minimum_spread": 0.05
}
]
}
]
}Error Example
json
{
"code": 500,
"message": "Internal Service Error",
"details": ""
}