大盤解析列表

介面描述

透過代幣（BTC/ETH）查詢 AI 大盤解析的歷史記錄，支援時間範圍篩選。

使用情境：

• 適用於按代幣 ID 精準查詢歷史大盤分析記錄
• 適用於圖表渲染等批量取得情境
• 適用於了解特定代幣的 AI 綜合訊號與壓力支撐結論

資料更新頻率：每 5 分鐘更新一次

請求 URL

• 方法：POST
• 路徑：/open/v1/ai/getMarketAnalysisList

積分消耗

• 消耗積分：3

前置條件

需要 vsTokenId，可透過 代幣列表 介面取得。

請求參數

參數透過請求本文（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
beginTime	string	否	開始時間（毫秒時間戳）
endTime	string	否	結束時間（毫秒時間戳），不傳則預設為目前時間
limit	integer	否	回傳數量，預設 200，範圍 1-2000
language	string	否	語言，支援 zh-CN / zh-TW / en-US / vi-VN，預設 zh-CN

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符號
icon	string	string	代幣圖示 URL
price	number	string	分析時價格
signal	string	string	AI 綜合訊號（如：HOLD / BUY / SELL）
klineDiff	number	string	K 線漲跌幅（小數，如 -0.003 表示 -0.3%）
supports	array	array<string>	支撐位價格列表（價格字串）
resistances	array	array<string>	壓力位價格列表（價格字串）
analysis	string	string	AI 分析結論（請求語言版本）
analysisTime	long	long	分析時間（毫秒時間戳）

欄位業務意義

欄位	業務意義	使用建議
vsTokenId	代幣唯一識別	與請求參數對應，用於資料歸屬校驗
symbol	代幣交易符號（如 BTC、ETH）	用於 UI 展示
icon	代幣圖示 URL	用於前端渲染
price	本條分析發布時的代幣價格	與 analysis 配合理解價格背景
signal	AI 綜合方向訊號（如：HOLD / BUY / SELL）	快速判斷 AI 整體傾向
klineDiff	K 線變動幅度（小數，正值為漲，負值為跌）	與 signal 配合判斷價格動能
supports	AI 計算出的關鍵支撐價格列表	關注最近支撐位，輔助止損
resistances	AI 計算出的關鍵壓力價格列表	關注最近壓力位，輔助止盈
analysis	按請求語言回傳的 AI 綜合分析結論（string）	直接展示給用戶，無需客戶端再做語言分支處理
analysisTime	分析記錄的時間戳	用於按時間排序和展示

請求範例

{
    "vsTokenId": 1,                 // 代幣 ID
    "beginTime": "1775732440000",   // 開始時間
    "endTime": "1775734240000",     // 結束時間
    "limit": 200,                   // 回傳數量
    "language": "zh-CN"             // 語言（可選，預設 zh-CN）
}

cURL 範例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/ai/getMarketAnalysisList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "beginTime": "1775732440000",
    "endTime": "1775734240000",
    "limit": 200,
    "language": "zh-CN"
}'

cURL 範例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/ai/getMarketAnalysisList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"beginTime\": \"1775732440000\",    \"endTime\": \"1775734240000\",    \"limit\": 200,    \"language\": \"zh-CN\"}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // 代幣 ID
            "symbol": "BTC",                                             // 代幣符號
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // 代幣圖示 URL
            "price": "80573.75",                                         // 分析時價格
            "signal": "HOLD",                                            // AI 綜合訊號
            "klineDiff": "-0.00298373",                                  // K 線漲跌幅（小數）
            "supports": ["80434.275", "79980.475"],                      // 支撐位價格列表
            "resistances": ["80776.78", "81208.86"],                     // 壓力位價格列表
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // AI 分析結論（目前語言版本）
            "analysisTime": 1778837430000                                // 分析時間
        }
    ],
    "requestId": "2055219406232641536"
}