Query Quotes

This endpoint provides crypto quote information with two query methods:

1. Single Crypto Quote: Query quote for a single crypto
2. Batch Crypto Quotes: Query quotes for multiple cryptos (up to 30 cryptos from the same market)

---

Single Crypto Quote

Query quote information for a single crypto.

HTTP Request

GET /market/v1/tickers/{symbol}/quote

Request Parameters

Name	Type	Required	Description
symbol	STRING	YES	Crypto trading pair symbol, e.g., BTC-USDT

Example cURL Request

curl --location --request GET '{$base_url}/market/v1/tickers/BTC-USDT/quote' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142'

---

Batch Crypto Quotes

Query quote information for multiple cryptos in a single request.

HTTP Request

GET /market/v1/tickers/quotes

Request Parameters

Name	Type	Required	Description
symbols	STRING	YES	Multiple crypto trading pair symbols separated by commas, e.g., BTC-USDT,ETH-USDT. Must be from the same market. Maximum 30 symbols per request.
market	STRING	YES	Market code (e.g., "dcex"). All symbols must belong to this market.

Example cURL Request

curl --location --request GET '{$base_url}/market/v1/tickers/quotes?market=dcex&symbols=BTC-USDT,ETH-USDT,LTC-USDT' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142'

---

Response Format

Both endpoints return the same quote data structure.

Single Crypto Response Fields

Field	Type	Description
symbol	STRING	Symbol
status	STRING	Status, See crypto_status enum for supported values.
close	DECIMAL	Close Price
prev_close	DECIMAL	Previous Close Price
name	STRING	Crypto Name
open	DECIMAL	Open Price
high	DECIMAL	Highest Price
low	DECIMAL	Lowest Price
volume	DECIMAL	Volume
turnover	DECIMAL	Turnover

Single Crypto Response Example

{
	"code": 0,
	"data": {
		"symbol": "BTC-USDT",
		"status": "normal",
		"close": 45325.78,
		"prev_close": 44327.55,
		"name": "Bitcoin",
		"market": "dcex",
		"open": 45498.6,
        "high": 45598.6,
        "low": 45398.6,
        "volume": 1.25,
        "turnover": 56873.25
	}
}

Batch Quotes Response Fields

Field	Type	Description
symbol	STRING	Symbol
status	STRING	Status, See crypto_status enum for supported values.
close	DECIMAL	Close Price
prev_close	DECIMAL	Previous Close Price
name	STRING	Crypto Name
market	STRING	Market
open	DECIMAL	Open Price
high	DECIMAL	Highest Price
low	DECIMAL	Lowest Price
volume	DECIMAL	Volume
turnover	DECIMAL	Turnover

Batch Quotes Response Example

{
	"code": 0,
	"data": [
        {
            "symbol": "BTC-USDT",
			"status": "normal",
			"close": 45325.78,
			"prev_close": 44327.55,
			"name": "Bitcoin",
			"market": "dcex",
			"open": 45498.6,
        	"high": 45598.6,
        	"low": 45398.6,
        	"volume": 1.25,
        	"turnover": 56873.25
        },
		{
			"symbol": "ETH-USDT",
			"status": "normal",
			"close": 3150.25,
			"prev_close": 3149.8,
			"name": "Ethereum",
			"market": "dcex",
			"open": 3498.6,
        	"high": 3598.6,
        	"low": 3098.6,
        	"volume": 1123.25,
        	"turnover": 56873.25
		},
		{
			"symbol": "LTC-USDT",
			"status": "normal",
			"close": 85.25,
			"prev_close": 84.80,
			"name": "Litecoin",
			"market": "dcex",
			"open": 98.6,
        	"high": 98.6,
        	"low": 80.6,
        	"volume": 1233.25,
        	"turnover": 56873.25
		}
	]
}

Error Response Example

{
	"code": 500,
	"message": "Internal Service Error",
	"details": ""
}