Query Quotes
Endpoint Information
This API provides quote information with two query methods:
- Single Quote: Query a single quote for one ticker
- Batch Quotes: Query quotes in batch for multiple tickers (up to 30 tickers from the same market)
Single Quote
Endpoint: GET /market/v1/tickers/{symbol}/quote
Description: Query a single quote for one ticker
Authentication: Institution API Key + Signature (non-Maker API endpoint — X-Maker-Addr is not required). See Authorization
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | STRING | Yes | Ticker symbol, e.g., AAPLs |
Batch Quotes
Endpoint: GET /market/v1/tickers/quotes
Description: Query quotes in batch for multiple tickers in a single request
Authentication: Institution API Key + Signature (non-Maker API endpoint — X-Maker-Addr is not required). See Authorization
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbols | STRING | Yes | Multiple ticker symbols separated by commas, e.g., AAPLs,TSLAs. Must be from the same market. Maximum 30 symbols per request |
| market | ENUM | Yes | Market code. See Market enum type description |
Response Parameters
Both single and batch endpoints return the same quote data structure. Single returns a single object; batch returns an array.
| Field | Type | Description |
|---|---|---|
| symbol | STRING | Trading pair symbol |
| status | ENUM | Status of the Stove security token. See CryptoStatus enum type description |
| close | DECIMAL | Close price |
| prev_close | DECIMAL | Previous close price |
| name | STRING | Instrument name |
| market | STRING | Market code |
| open | DECIMAL | Open price |
| high | DECIMAL | Highest price |
| low | DECIMAL | Lowest price |
| volume | DECIMAL | Trading volume |
| turnover | DECIMAL | Trading amount |
Request Example
Single Quote
bash
curl -X GET "{API_BASE_URL}/market/v1/tickers/AAPLs/quote" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Timestamp: 1746774142000" \
-H "X-API-Signature: GENERATED_SIGNATURE"Batch Quotes
bash
curl -X GET "{API_BASE_URL}/market/v1/tickers/quotes?market=usex&symbols=AAPLs,TSLAs" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Timestamp: 1746774142000" \
-H "X-API-Signature: GENERATED_SIGNATURE"Response Example
Single Quote
json
{
"code": 0,
"data": {
"symbol": "AAPLs",
"status": "normal",
"open": 295.355,
"high": 299.7,
"low": 292.94,
"close": 293.08,
"prev_close": 294.3,
"name": "Apple Inc.",
"market": "usex",
"volume": 53081859,
"turnover": 15651094408.3453
}Batch Quotes
json
{
"code": 0,
"data": [
{
"symbol": "AAPLs",
"status": "normal",
"open": 295.355,
"high": 299.7,
"low": 292.94,
"close": 293.08,
"prev_close": 294.3,
"name": "Apple Inc.",
"market": "usex",
"volume": 53081859,
"turnover": 15651094408.3453
},
{
"symbol": "TSLAs",
"status": "normal",
"open": 380.08,
"high": 384.58,
"low": 373.05,
"close": 375.53,
"prev_close": 381.61,
"name": "Tesla, Inc.",
"market": "usex",
"volume": 37081421,
"turnover": 14034965432.8585
}
]
}Error Example
json
{
"code": 500,
"message": "Internal Service Error",
"details": ""
}