Risk token list
Description
Returns a list of tokens tracked by AI across multiple data dimensions that show downside risk trends in current market conditions.
Use cases:
- Query tokens with downside risk in current conditions
- Risk alerts and position avoidance reference
Data refresh: Updated every 5 minutes
Endpoint
- Method:
POST - Path:
/open/v1/ai/getRiskCoinList
Points
- Points per call:
6
Prerequisites
No prerequisites; you can call this API directly.
Request parameters
Parameters are sent in the request body as JSON.
No request parameters.
Response fields
Field structure for each object in the data array only:
| Field | Type | Actual serialized type | Description |
|---|---|---|---|
| vsTokenId | long | string | Token ID |
| symbol | string | string | Token symbol |
| price | number | string | Current price (USD) |
| maxPrice | number | string | Historical high price (USD) |
| minPrice | number | string | Historical low price (USD) |
| percentChange1h | number | string | 1-hour price change percentage |
| percentChange24h | number | string | 24-hour price change percentage |
| percentChange7d | number | string | 7-day price change percentage |
| percentChange30d | number | string | 30-day price change percentage |
| percentChange60d | number | string | 60-day price change percentage |
| percentChange90d | number | string | 90-day price change percentage |
| cost | number | string | Major-player cost price (USD) |
| costChange | number | string | Cost change rate |
| deviation | number | string | Price deviation (%) |
| marketCap | number | string | Market cap (USD) |
| marketCapRanking | integer | integer | Market cap rank |
| circulatingSupply | number | string | Circulating supply |
| circulationRate | number | string | Circulation rate (%) |
| active | integer | string | 24h active addresses |
| newly | integer | string | 24h new addresses |
| tradeType | integer | integer | Trade type (1: spot, 2: futures, 3: delivery futures) |
| chanceCoinTradeDataV1Vos | array | array | Trade time data list |
| timeRange | string | string | Time range identifier (e.g. m15, H4) |
| timeParticleEnum | integer | integer | Time granularity enum value |
| tradeInflow | number | string | Net trade inflow amount (USD) |
| tradeAmount | number | string | Total trade amount (USD) |
| updateTime | long | long | Update time (millisecond timestamp) |
| pushPrice | number | string | Risk push price (USD) |
| pushMaxPrice | number | string | Highest price after push (USD) |
| gains | number | number | Upside move after push (%) |
| pushMinPrice | number | string | Lowest price after push (USD) |
| declines | number | number | Drawdown after push (%) |
| score | number | number | AI risk score |
| bullishRatio | number | number | Bullish sentiment ratio |
| bearishRatio | number | number | Bearish sentiment ratio |
Field semantics
The following fields require additional business context:
| Field | Business meaning | Range / calculation | Usage suggestion |
|---|---|---|---|
| cost | Major-player cost price | Weighted major-player holding cost from large trades | When current price is above cost, major players may take profit |
| deviation | Price deviation | (Current price - major-player cost) / major-player cost * 100% | Watch for pullback risk when positive deviation is too large |
| score | AI risk score | Range 0–100, composite of capital flow, technical indicators, etc. | Score <= 45 or >= 80: watchlist tokens; 45 < score < 75: observe tokens; 75 < score < 80: downside-risk tokens |
| pushPrice | Risk push price | Price when the system first pushed this risk token | Use to calculate upside/downside after push |
| declines | Drawdown after push | (pushPrice - pushMinPrice) / pushPrice * 100% | Validate risk alert accuracy |
| tradeInflow | Net trade inflow | Positive means inflow; negative means outflow | Sustained negative values indicate distribution |
Enum reference
tradeType — trade type
| Value | Meaning |
|---|---|
| 1 | Spot |
| 2 | Perpetual futures |
| 3 | Delivery futures |
timeParticleEnum — time granularity
| Value | Meaning |
|---|---|
| 5 | 5 minutes |
| 15 | 15 minutes |
| 30 | 30 minutes |
| 101 | 1 hour |
| 104 | 4 hours |
| 106 | 6 hours |
| 124 | 24 hours |
| 201 | 1 day |
| 202 | 2 days |
| 207 | 7 days |
| 230 | 30 days |
Request example
json
{}cURL example (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 '{}'cURL example (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 "{}"Sample success response
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "38178", // Token ID
"symbol": "TRUTH", // Token symbol
"price": "0.009401", // Current price
"maxPrice": "0.0501747614230509", // Highest price
"minPrice": "0.008377211395908427", // Lowest price
"percentChange1h": "-0.416791", // 1-hour price change percentage
"percentChange24h": "-0.22235364", // 24-hour price change percentage
"percentChange7d": "-0.64120527", // 7-day price change percentage
"percentChange30d": "-33.88558117", // 30-day price change percentage
"percentChange60d": "-36.70969242", // 60-day price change percentage
"percentChange90d": "-52.50016328", // 90-day price change percentage
"cost": "", // Cost price
"costChange": "", // Cost change
"deviation": "", // Deviation
"marketCap": "19433307.396503072", // Market cap
"marketCapRanking": 427, // Market cap rank
"circulatingSupply": "2085305300", // Circulating supply
"circulationRate": "20.853053", // Circulation rate
"active": "", // Active addresses
"newly": "", // New addresses
"tradeType": 2, // Trade type (1: spot, 2: futures, 3: delivery futures)
"chanceCoinTradeDataV1Vos": [], // Trade time data list
"updateTime": 1771287000000, // Update time
"pushPrice": "0.01565", // Push price
"pushMaxPrice": "0.016266", // Highest price after push
"gains": 0.0, // Upside move
"pushMinPrice": "0.0088", // Lowest price after push
"declines": 43.769968, // Drawdown
"score": 36.5, // Current score
"bullishRatio": "", // Bullish ratio
"bearishRatio": "" // Bearish ratio
},
{
"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", // Time range
"timeParticleEnum": 30, // Time range enum value
"tradeInflow": "-69560.54264", // Net trade inflow amount
"tradeAmount": "350999.52609999996" // Trade amount
},
{
"timeRange": "D2",
"timeParticleEnum": 202,
"tradeInflow": "-713799.0313099995",
"tradeAmount": "30846831.661049996"
},
{
"timeRange": "H6",
"timeParticleEnum": 106,
"tradeInflow": "-387193.49147999985",
"tradeAmount": "4142104.91086"
}
// ... more items omitted
],
"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
}
// ... more items omitted
],
"requestId": "xxx-xxx-xxx"
}