Skip to content
Stove Website

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 ​

ParameterTypeRequiredDescription
marketENUMYesMarket code (path parameter). See Market enum type description

Response Parameters ​

FieldTypeDescription
codeSTRINGSpread table code
price_bandsOBJECT[]Price bands list

price_bands Object

FieldTypeDescription
fromDECIMALStarting price
toDECIMALEnding price
minimum_spreadDECIMALMinimum 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": ""
}