Danh sách token rủi ro
Mô tả API
Lấy danh sách token mà AI theo dõi qua dữ liệu đa chiều, có xu hướng rủi ro giảm giá trong điều kiện thị trường hiện tại.
Tình huống sử dụng:
- Truy vấn token có rủi ro giảm giá trong điều kiện thị trường hiện tại
- Cảnh báo rủi ro và tham khảo tránh nắm giữ
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/getRiskCoinList
Tiêu hao điểm tích lũy
- Điểm tích lũy mỗi lần gọi:
6
Điều kiện tiên quyết
Không có điều kiện tiên quyết; có thể gọi trực tiếp.
Tham số yêu cầu
Truyền tham số trong body dưới dạng JSON.
Không có tham số yêu cầu.
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 |
| price | number | string | Giá hiện tại (USD) |
| maxPrice | number | string | Giá cao nhất lịch sử (USD) |
| minPrice | number | string | Giá thấp nhất lịch sử (USD) |
| percentChange1h | number | string | Phần trăm thay đổi giá 1 giờ |
| percentChange24h | number | string | Phần trăm thay đổi giá 24 giờ |
| percentChange7d | number | string | Phần trăm thay đổi giá 7 ngày |
| percentChange30d | number | string | Phần trăm thay đổi giá 30 ngày |
| percentChange60d | number | string | Phần trăm thay đổi giá 60 ngày |
| percentChange90d | number | string | Phần trăm thay đổi giá 90 ngày |
| cost | number | string | Giá chi phí vốn chủ lực (USD) |
| costChange | number | string | Tỷ lệ thay đổi chi phí |
| deviation | number | string | Độ lệch giá (%) |
| marketCap | number | string | Vốn hóa thị trường (USD) |
| marketCapRanking | integer | integer | Xếp hạng vốn hóa |
| circulatingSupply | number | string | Lượng cung lưu hành |
| circulationRate | number | string | Tỷ lệ lưu hành (%) |
| active | integer | string | Số địa chỉ hoạt động 24h |
| newly | integer | string | Số địa chỉ mới 24h |
| tradeType | integer | integer | Loại giao dịch (1: Spot 2: Hợp đồng 3: Hợp đồng giao hàng) |
| chanceCoinTradeDataV1Vos | array | array | Danh sách dữ liệu giao dịch theo thời gian |
| timeRange | string | string | Mã khoảng thời gian (ví dụ m15, H4) |
| timeParticleEnum | integer | integer | Giá trị enum độ chi tiết thời gian |
| tradeInflow | number | string | Số tiền dòng tiền ròng giao dịch (USD) |
| tradeAmount | number | string | Tổng số tiền giao dịch (USD) |
| updateTime | long | long | Thời gian cập nhật (timestamp mili giây) |
| pushPrice | number | string | Giá đẩy cảnh báo rủi ro (USD) |
| pushMaxPrice | number | string | Giá cao nhất sau khi đẩy (USD) |
| gains | number | number | Mức tăng sau khi đẩy (%) |
| pushMinPrice | number | string | Giá thấp nhất sau khi đẩy (USD) |
| declines | number | number | Mức giảm sau khi đẩy (%) |
| score | number | number | Điểm rủi ro AI |
| bullishRatio | number | number | Tỷ lệ tâm lý tăng giá |
| bearishRatio | number | number | Tỷ lệ tâm lý giảm giá |
Ý nghĩa nghiệp vụ
Các trường sau cần giải thích rõ ý nghĩa nghiệp vụ:
| Trường | Ý nghĩa | Phạm vi / Cách tính | Gợi ý sử dụng |
|---|---|---|---|
| cost | Giá chi phí vốn chủ lực | Chi phí nắm giữ vốn chủ lực tính theo trọng số giao dịch lớn | Khi giá hiện tại cao hơn giá chi phí, vốn chủ lực có thể chốt lời |
| deviation | Độ lệch giá | (Giá hiện tại - Chi phí vốn chủ lực) / Chi phí vốn chủ lực * 100% | Khi giá trị dương quá lớn cần cảnh giác rủi ro điều chỉnh |
| score | Điểm rủi ro AI | Phạm vi 0-100, tính tổng hợp từ dòng vốn, chỉ báo kỹ thuật, v.v. | Điểm <= 45 hoặc >= 80: token chờ quan sát; 45 < điểm < 75: token quan sát; 75 < điểm < 80: token rủi ro giảm |
| pushPrice | Giá đẩy cảnh báo rủi ro | Giá tại thời điểm hệ thống lần đầu đẩy token rủi ro này | Dùng để tính mức tăng/giảm sau khi đẩy |
| declines | Mức giảm sau khi đẩy | (pushPrice - pushMinPrice) / pushPrice * 100% | Xác minh độ chính xác của cảnh báo rủi ro |
| tradeInflow | Dòng tiền ròng giao dịch | Giá trị dương là dòng vốn vào, giá trị âm là dòng vốn ra | Giá trị âm liên tục cho thấy vốn chủ lực đang xả hàng |
Giải thích giá trị enum
tradeType - Loại giao dịch
| Giá trị | Ý nghĩa |
|---|---|
| 1 | Spot |
| 2 | Hợp đồng (vĩnh viễn) |
| 3 | Hợp đồng giao hàng |
timeParticleEnum - Độ chi tiết thời gian
| Giá trị | Ý nghĩa |
|---|---|
| 5 | 5 phút |
| 15 | 15 phút |
| 30 | 30 phút |
| 101 | 1 giờ |
| 104 | 4 giờ |
| 106 | 6 giờ |
| 124 | 24 giờ |
| 201 | 1 ngày |
| 202 | 2 ngày |
| 207 | 7 ngày |
| 230 | 30 ngày |
Ví dụ yêu cầu
json
{}Ví dụ cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{}'Ví dụ cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{}"Ví dụ phản hồi thành công
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "38178", // Token ID
"symbol": "TRUTH", // Ký hiệu token
"price": "0.009401", // Giá hiện tại
"maxPrice": "0.0501747614230509", // Giá cao nhất
"minPrice": "0.008377211395908427", // Giá thấp nhất
"percentChange1h": "-0.416791", // Phần trăm thay đổi giá 1 giờ
"percentChange24h": "-0.22235364", // Phần trăm thay đổi giá 24 giờ
"percentChange7d": "-0.64120527", // Phần trăm thay đổi giá 7 ngày
"percentChange30d": "-33.88558117", // Phần trăm thay đổi giá 30 ngày
"percentChange60d": "-36.70969242", // Phần trăm thay đổi giá 60 ngày
"percentChange90d": "-52.50016328", // Phần trăm thay đổi giá 90 ngày
"cost": "", // Giá chi phí
"costChange": "", // Thay đổi chi phí
"deviation": "", // Độ lệch
"marketCap": "19433307.396503072", // Vốn hóa
"marketCapRanking": 427, // Xếp hạng vốn hóa
"circulatingSupply": "2085305300", // Lượng cung lưu hành
"circulationRate": "20.853053", // Tỷ lệ lưu hành
"active": "", // Địa chỉ hoạt động
"newly": "", // Địa chỉ mới
"tradeType": 2, // Loại giao dịch (1: Spot 2: Hợp đồng 3: Hợp đồng giao hàng)
"chanceCoinTradeDataV1Vos": [], // Danh sách dữ liệu giao dịch theo thời gian
"updateTime": 1771287000000, // Thời gian cập nhật
"pushPrice": "0.01565", // Giá đẩy
"pushMaxPrice": "0.016266", // Giá cao nhất sau khi đẩy
"gains": 0.0, // Mức tăng
"pushMinPrice": "0.0088", // Giá thấp nhất sau khi đẩy
"declines": 43.769968, // Mức giảm
"score": 36.5, // Điểm hiện tại
"bullishRatio": "", // Tỷ lệ tăng giá
"bearishRatio": "" // Tỷ lệ giảm giá
},
{
"vsTokenId": "36341",
"symbol": "ASTER",
"price": "0.714",
"maxPrice": "2.419058923870731",
"minPrice": "0.08438718204444161",
"percentChange1h": "0.10564628",
"percentChange24h": "1.13663783",
"percentChange7d": "1.64029621",
"percentChange30d": "9.69143917",
"percentChange60d": "1.73287042",
"percentChange90d": "-25.22011773",
"cost": "1.172355914203435426",
"costChange": "0.881647",
"deviation": "67.240501",
"marketCap": "1767827178.5568295",
"marketCapRanking": 32,
"circulatingSupply": "2476688843.7843533",
"circulationRate": "30.958611",
"active": "7920",
"newly": "7920",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m30", // Khoảng thời gian
"timeParticleEnum": 30, // Giá trị enum khoảng thời gian
"tradeInflow": "-69560.54264", // Số tiền dòng tiền ròng giao dịch
"tradeAmount": "350999.52609999996" // Tổng số tiền giao dịch
},
{
"timeRange": "D2",
"timeParticleEnum": 202,
"tradeInflow": "-713799.0313099995",
"tradeAmount": "30846831.661049996"
},
{
"timeRange": "H6",
"timeParticleEnum": 106,
"tradeInflow": "-387193.49147999985",
"tradeAmount": "4142104.91086"
}
// ... bỏ qua thêm dữ liệu
],
"updateTime": 1772796000000,
"pushPrice": "0.702",
"pushMaxPrice": "0.721",
"gains": 0.0,
"pushMinPrice": "0.673",
"declines": 4.131054,
"score": 78.0,
"bullishRatio": 0.5,
"bearishRatio": 0.25
},
{
"vsTokenId": "36532",
"symbol": "B",
"price": "0.1778",
"maxPrice": "0.7315687936140746",
"minPrice": "0.001494456258922425",
"percentChange1h": "0.44653729",
"percentChange24h": "-0.00641715",
"percentChange7d": "-20.99954538",
"percentChange30d": "15.74594892",
"percentChange60d": "-34.99023983",
"percentChange90d": "-27.74099941",
"cost": "0.33326457023010802",
"costChange": "0",
"deviation": "83.819399",
"marketCap": "176827300.56855285",
"marketCapRanking": 125,
"circulatingSupply": "1000000000",
"circulationRate": "100",
"active": "154",
"newly": "154",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [],
"updateTime": 1773008700000,
"pushPrice": "0.2069",
"pushMaxPrice": "0.216",
"gains": 0.0,
"pushMinPrice": "0.1706",
"declines": 17.544708,
"score": 41.0,
"bullishRatio": 0.4286,
"bearishRatio": 0.0
}
// ... bỏ qua thêm dữ liệu
],
"requestId": "xxx-xxx-xxx"
}