Danh sách phân tích thị trường

Mô tả API

Truy vấn lịch sử phân tích thị trường AI theo token (BTC/ETH), hỗ trợ lọc theo khoảng thời gian.

Tình huống sử dụng:

Truy vấn chính xác lịch sử phân tích thị trường theo token ID
Lấy dữ liệu hàng loạt cho các tình huống như hiển thị biểu đồ
Theo dõi tín hiệu tổng hợp AI và kết luận hỗ trợ/kháng cự của một token cụ thể

Tần suất cập nhật dữ liệu: mỗi 5 phút

URL yêu cầu

Phương thức: POST
Đường dẫn: /open/v1/ai/getMarketAnalysisList

Tiêu hao điểm tích lũy

Điểm tích lũy mỗi lần gọi: 3

Điều kiện tiên quyết

Cần có vsTokenId, có thể lấy qua API danh sách token.

Tham số yêu cầu

Truyền tham số trong body dưới dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	Token ID
beginTime	string	Không	Thời gian bắt đầu (timestamp mili giây)
endTime	string	Không	Thời gian kết thúc (timestamp mili giây), mặc định là thời gian hiện tại nếu không truyền
limit	integer	Không	Số lượng trả về, mặc định 200, phạm vi 1-2000
language	string	Không	Ngôn ngữ, hỗ trợ `zh-CN` / `zh-TW` / `en-US` / `vi-VN`, mặc định `zh-CN`

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong từng phần tử của mảng data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
vsTokenId	long	string	Token ID
symbol	string	string	Ký hiệu token
icon	string	string	URL biểu tượng token
price	number	string	Giá tại thời điểm phân tích
signal	string	string	Tín hiệu tổng hợp AI, ví dụ `HOLD` / `BUY` / `SELL`
klineDiff	number	string	Biến động K-line dạng số thập phân, ví dụ `-0.003` biểu thị `-0.3%`
supports	array	array<string>	Danh sách giá hỗ trợ (chuỗi giá)
resistances	array	array<string>	Danh sách giá kháng cự (chuỗi giá)
analysis	string	string	Kết luận phân tích AI theo ngôn ngữ yêu cầu
analysisTime	long	long	Thời gian phân tích (timestamp mili giây)

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa	Gợi ý sử dụng
vsTokenId	Định danh duy nhất của token	Tương ứng với tham số yêu cầu, dùng để kiểm tra quyền sở hữu dữ liệu
symbol	Ký hiệu giao dịch của token, ví dụ BTC, ETH	Dùng để hiển thị trên UI
icon	URL biểu tượng token	Dùng để render ở frontend
price	Giá token tại thời điểm bản phân tích này được phát hành	Kết hợp với `analysis` để hiểu bối cảnh giá
signal	Tín hiệu định hướng tổng hợp AI, ví dụ `HOLD` / `BUY` / `SELL`	Nhanh chóng đánh giá xu hướng tổng thể của AI
klineDiff	Mức biến động K-line. Giá trị dương là tăng, giá trị âm là giảm	Kết hợp với `signal` để đánh giá động lượng giá
supports	Danh sách giá hỗ trợ quan trọng do AI tính toán	Theo dõi mức hỗ trợ gần nhất để hỗ trợ quyết định cắt lỗ
resistances	Danh sách giá kháng cự quan trọng do AI tính toán	Theo dõi mức kháng cự gần nhất để hỗ trợ quyết định chốt lời
analysis	Kết luận phân tích tổng hợp AI được trả về theo ngôn ngữ yêu cầu (string)	Hiển thị trực tiếp cho người dùng, không cần xử lý nhánh ngôn ngữ ở client
analysisTime	Timestamp của bản ghi phân tích	Dùng để sắp xếp và hiển thị theo thời gian

Ví dụ yêu cầu

json

{
    "vsTokenId": 1,                 // Token ID
    "beginTime": "1775732440000",   // Thời gian bắt đầu
    "endTime": "1775734240000",     // Thời gian kết thúc
    "limit": 200,                   // Số lượng trả về
    "language": "zh-CN"             // Ngôn ngữ (tùy chọn, mặc định zh-CN)
}

Ví dụ cURL (Linux/macOS)

bash

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"
}'

Ví dụ cURL (Windows CMD)

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\"}"

Ví dụ phản hồi thành công

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // Token ID
            "symbol": "BTC",                                             // Ký hiệu token
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // URL biểu tượng token
            "price": "80573.75",                                         // Giá tại thời điểm phân tích
            "signal": "HOLD",                                            // Tín hiệu tổng hợp AI
            "klineDiff": "-0.00298373",                                  // Biến động K-line (số thập phân)
            "supports": ["80434.275", "79980.475"],                      // Danh sách giá hỗ trợ
            "resistances": ["80776.78", "81208.86"],                     // Danh sách giá kháng cự
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // Kết luận phân tích AI (ngôn ngữ hiện tại)
            "analysisTime": 1778837430000                                // Thời gian phân tích
        }
    ],
    "requestId": "2055219406232641536"
}

Danh sách phân tích thị trường ​

Mô tả API ​

URL yêu cầu ​

Tiêu hao điểm tích lũy ​

Điều kiện tiên quyết ​

Tham số yêu cầu ​

Trường phản hồi ​

Ý nghĩa nghiệp vụ ​

Ví dụ yêu cầu ​

Ví dụ cURL (Linux/macOS) ​

Ví dụ cURL (Windows CMD) ​

Ví dụ phản hồi thành công ​