Chỉ báo hành vi giá (BTC/ETH)

Mô tả API

Lấy dữ liệu chỉ báo đặc trưng về ảnh hưởng của hành vi vốn chủ lực lên xu hướng giá của BTC hoặc ETH trong khoảng thời gian cụ thể.

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

• Tham khảo đánh giá xu hướng giá lớn của BTC và ETH
• Nhận diện ảnh hưởng hành vi vốn chủ lực lên giá và đánh giá hướng xu hướng giá tổng 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/indicator/getPriceMarketList

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

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

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

Lấy vsTokenId

Điều kiện	Mô tả	Cách lấy
Đã có vsTokenId	Dùng trực tiếp vsTokenId đã cache, không cần truy vấn lại	Tự động lấy từ ngữ cảnh
Chưa có vsTokenId	Gọi API POST /vs-token/list	Gọi API tiên quyết

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
startTime	long	Không	Thời gian bắt đầu (timestamp mili giây)
endTime	long	Có	Thời gian kết thúc (timestamp mili giây)

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
date	long	long	Thời gian (timestamp mili giây)
priceMarketType	integer	integer	Xu hướng giá (1: tăng, 2: giảm)

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa	Gợi ý sử dụng
priceMarketType	Nhãn xu hướng giá	1 biểu thị giai đoạn tăng, 2 biểu thị giai đoạn giảm, dùng đánh giá xu hướng giá hiện tại

Giải thích giá trị enum

priceMarketType - Xu hướng giá

Giá trị	Ý nghĩa
1	Tăng
2	Giảm

Ví dụ yêu cầu

{
    "vsTokenId": 1,           // Token ID
    "startTime": 1770825600000, // Thời gian bắt đầu (timestamp)
    "endTime": 1773417600000    // Thời gian kết thúc (timestamp)
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/indicator/getPriceMarketList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/indicator/getPriceMarketList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

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

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                     // Token ID
            "symbol": "BTC",                      // Ký hiệu token
            "date": 1773158400000,                // Thời gian
            "priceMarketType": 1                   // Xu hướng giá (1: tăng, 2: giảm)
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149400000,
            "priceMarketType": 1
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149100000,
            "priceMarketType": 1
        }
        // ... bỏ qua thêm dữ liệu
    ],
    "requestId": "xxx-xxx-xxx"
}