報價資訊

此端點提供加密貨幣報價資訊，有兩種查詢方式：

1. 單一加密貨幣報價：查詢單一加密貨幣的報價
2. 批量加密貨幣報價：查詢多個加密貨幣的報價（同一市場最多 30 個加密貨幣）

---

單一加密貨幣報價

查詢單一加密貨幣的報價資訊。

HTTP 請求

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

請求參數

參數名稱	類型	是否必填	說明
symbol	STRING	是	加密貨幣交易對代碼，例如：BTC-USDT

cURL 請求範例

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'

---

批量加密貨幣報價

在單一請求中查詢多個加密貨幣的報價資訊。

HTTP 請求

GET /market/v1/tickers/quotes

請求參數

參數名稱	類型	是否必填	說明
symbols	STRING	是	多個加密貨幣交易對代碼用逗號分隔，例如：BTC-USDT,ETH-USDT。必須來自同一市場。每次請求最多 30 個代碼。
market	STRING	是	市場代碼（例如："dcex"）。所有加密貨幣代碼必須屬於此市場。

cURL 請求範例

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'

---

回應格式

兩種端點都返回相同的報價資料結構。

單一加密貨幣回應欄位

欄位名稱	類型	說明
symbol	STRING	加密貨幣交易對代碼
status	STRING	加密货币状态，詳見股票状态枚舉定義中的值
close	DECIMAL	收盤價
prev_close	DECIMAL	昨收價
name	STRING	加密貨幣名稱
market	STRING	市場
open	DECIMAL	開盤價
high	DECIMAL	最高價
low	DECIMAL	最低價
volume	DECIMAL	成交量
turnover	DECIMAL	成交額

單一加密貨幣回應範例

{
	"code": 0,
	"data": {
		"symbol": "BTC-USDT",
		"status": "normal",
		"close": 45325.78,
		"prev_close": 44327.55,
		"name": "Bitcoin",
		"market": "dcex",
		"open": 45506,
        "high": 45606.5,
        "low": 45396,
        "volume": 125.45,
        "turnover": 5708234.56
	}
}

批量報價回應欄位

欄位名稱	類型	說明
symbol	STRING	加密貨幣交易對代碼
status	STRING	加密货币状态，詳見股票状态枚舉定義中的值
close	DECIMAL	收盤價
prev_close	DECIMAL	昨收價
name	STRING	加密貨幣名稱
market	STRING	市場
open	DECIMAL	開盤價
high	DECIMAL	最高價
low	DECIMAL	最低價
volume	DECIMAL	成交量
turnover	DECIMAL	成交額

批量報價回應範例

{
	"code": 0,
	"data": [
        {
            "symbol": "BTC-USDT",
			"status": "normal",
			"close": 45325.78,
			"prev_close": 44327.55,
			"name": "Bitcoin",
			"market": "dcex",
			"open": 45506,
        	"high": 45606.5,
        	"low": 45396,
        	"volume": 125.45,
        	"turnover": 5708234.56
        },
		{
			"symbol": "ETH-USDT",
			"status": "normal",
			"close": 3150.25,
			"prev_close": 3149.8,
			"name": "Ethereum",
			"market": "dcex",
			"open": 5506,
        	"high": 5606.5,
        	"low": 3296,
        	"volume": 125.45,
        	"turnover": 5708234.56
		},
		{
			"symbol": "LTC-USDT",
			"status": "normal",
			"close": 85.25,
			"prev_close": 84.80,
			"name": "Litecoin",
			"market": "dcex",
			"open": 56,
        	"high": 66.5,
        	"low": 36,
        	"volume": 125.45,
        	"turnover": 5708234.56
		}
	]
}

錯誤回應範例

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