查詢歷史K線

此端點用於查詢用戶歷史及當前加密貨幣K線的分頁列表，支援依市場及時間範圍篩選。

HTTP 請求

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

請求參數

參數名稱	類型	是否必填	說明
market	ENUM	是	市場代碼。詳見market 列舉支援值。
start_time	LONG	是	起始時間，UNIX 時間戳（秒）。
end_time	LONG	是	結束時間，UNIX 時間戳（秒）。
interval	ENUM	是	K綫周期，詳見interval枚舉定義中的值
limit	INT	否	頁K綫數量，默認：100，最大1000。

cURL 請求範例

curl --location --request GET '{$base_url}/market/v1/tickers/BTC-USDT/klines?market=dcex&interval=day&start_time=1745996160&end_time=1748588160' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142'

回應欄位

欄位名稱	類型	說明
time	STRING	K綫時間
open	DECIMAL	開盤價
high	DECIMAL	最高價
low	DECIMAL	最低價
close	DECIMAL	收盤價
volume	DECIMAL	成交量
turnover	DECIMAL	成交額
change	DECIMAL	漲跌額
percentage_change	DECIMAL	漲跌幅%
turnover_rate	DECIMAL	換手率%

成功回應範例

{
    "code": 0,
    "data": [
        {
            "time": "2025-04-30 11:30:00",
            "open": 209.09,
            "high": 210.60,
            "low": 208.45,
            "close": 210.28,
            "volume": 2905057,
            "turnover": 609394203.45,
            "change": 1.19500000,
            "percentage_change": 0.57,
            "turnover_rate": 0.019
        },
        {
            "time": "2025-04-30 12:30:00",
            "open": 210.30,
            "high": 211.02,
            "low": 209.69,
            "close": 210.33,
            "volume": 2135477,
            "turnover": 449913588.39,
            "change": 0.04500000,
            "percentage_change": 0.02,
            "turnover_rate": 0.014
        }
    ]
}

錯誤範例

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

---

查詢日内K線

此端點用於查詢用戶日内加密貨幣K線的分頁列表，支援依市場及時間範圍篩選。

HTTP 請求

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

請求參數

參數名稱	類型	是否必填	說明
market	ENUM	是	市場代碼。詳見市場 列舉支援值。
symbol	STRING	是	加密貨幣代碼。
session	ENUM	是	交易會話。詳見交易會話 列舉支援值。

cURL 請求範例

curl --location --request GET '{$base_url}/market/v1/tickers/BTC-USDT/charts?market=dcex&session=trading' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142'

回應欄位

欄位名稱	類型	說明
time	STRING	K綫時間
open	DECIMAL	開盤價
high	DECIMAL	最高價
low	DECIMAL	最低價
close	DECIMAL	收盤價
volume	DECIMAL	成交量
turnover	DECIMAL	成交額
change	DECIMAL	漲跌額
percentage_change	DECIMAL	漲跌幅%

成功回應範例

{
    "code": 0,
    "data": [
        {
            "time": "2025-04-30 11:30:00",
            "open": 209.09,
            "high": 210.60,
            "low": 208.45,
            "close": 210.28,
            "volume": 2905057,
            "turnover": 609394203.45,
            "change": 1.19500000,
            "percentage_change": 0.57
        },
        {
            "time": "2025-04-30 12:30:00",
            "open": 210.30,
            "high": 211.02,
            "low": 209.69,
            "close": 210.33,
            "volume": 2135477,
            "turnover": 449913588.39,
            "change": 0.04500000,
            "percentage_change": 0.02
        }
    ]
}

錯誤範例

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