Risk token messages
Description
Returns AI tracking messages for tokens with downside risk in current market conditions, derived from multiple data dimensions.
Use cases:
- Query AI real-time tracking messages for tokens with downside risk in current conditions
- Understand risk signals such as exit warnings, downside risk, rebounds, etc.
Data refresh: Updated every 5 minutes
Endpoint
- Method:
POST - Path:
/open/v1/ai/getRiskCoinMessageList
Points
- Points per call:
5
Prerequisites
Obtaining
vsTokenId
| Condition | Description | How to obtain |
|---|---|---|
Already have vsTokenId | Use the cached vsTokenId directly; no need to query again | Extracted automatically from context |
Do not have vsTokenId | Call POST /vs-token/list | Prerequisite API call |
Request parameters
Parameters are sent in the request body as JSON.
| Parameter | Type | Required | Description |
|---|---|---|---|
| vsTokenId | long | Yes | Token ID |
Response fields
Field structure for each object in the data array only:
| Field | Type | Actual serialized type | Description |
|---|---|---|---|
| updateTime | long | long | Update time (millisecond timestamp) |
| vsTokenId | long | string | VS Token ID |
| symbol | string | string | Token symbol |
| name | string | string | Token name |
| riskMessageType | integer | integer | Prediction type |
| scoring | number | number | Score (may return empty string) |
| grade | integer | integer | Grade (may return empty string) |
| price | number | string | Token price |
| percentChange24h | number | number | 24-hour price change |
| riskDecline | number | number | Risk drawdown |
| rebound | number | number | Rebound |
Field semantics
| Field | Business meaning | Usage suggestion |
|---|---|---|
| riskMessageType | Risk message type | Identifies risk signal types such as exit warnings, downside risk, rebounds, etc. |
| riskDecline | Risk drawdown | Price decline after push; use to validate risk alert accuracy |
| rebound | Rebound magnitude | Degree of rebound after price decline |
Request example
json
{
"vsTokenId": 38178 // Token ID
}cURL example (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 38178
}'cURL example (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 38178}"Sample success response
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1771317300000, // Update time
"vsTokenId": "38178", // VS Token ID
"symbol": "TRUTH", // Token symbol
"name": "Swarm Network", // Token name
"riskMessageType": 19, // Prediction type
"scoring": "", // Score
"grade": "", // Grade
"price": "0.011799", // Token price
"percentChange24h": -2.32385979, // 24-hour price change
"riskDecline": 26.376997000000003, // Risk drawdown
"rebound": 6.613434999999999 // Rebound
},
{
"updateTime": 1771317000000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.013825",
"percentChange24h": -0.69409195,
"riskDecline": 15.444089,
"rebound": 4.466107
},
{
"updateTime": 1771316700000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.014154",
"percentChange24h": -0.69409195,
"riskDecline": 10.402556,
"rebound": 0.927115
}
// ... more items omitted
],
"requestId": "xxx-xxx-xxx"
}