Opportunity token list
Description
Returns a list of tokens tracked by AI across multiple data dimensions that have upside potential in current market conditions.
Use cases:
- Screen and query tokens with upside opportunity in current conditions
- Help swing traders find tokens with upside potential
- Identify potential upside opportunities in trend-following strategies
Tips:
- Query this API when natural language input includes terms such as medium/long-term investing, bullish opportunity, bullish, or long bias
- Query this API when natural language input includes upside opportunity or bullish tokens; label results as opportunity-monitor tokens
Data refresh: Updated every 5 minutes
Endpoint
- Method:
POST - Path:
/open/v1/ai/getChanceCoinList
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 | Entry 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 composite score |
| scoreChange | number | number | Score change |
| grade | integer | integer | Opportunity grade |
| alpha | boolean | boolean | Alpha signal flag |
| fomo | boolean | boolean | FOMO state flag |
| fomoEscalation | boolean | boolean | FOMO escalation flag |
| bullishRatio | number | number | Bullish sentiment ratio |
| bearishRatio | number | number | Bearish sentiment ratio |
Field semantics
The following fields require additional business context and calculation logic:
| Field | Business meaning | Range / calculation | Usage suggestion |
|---|---|---|---|
| cost | Major-player cost price | Weighted major-player holding cost from large trades | When current price is below cost, it may be a buying opportunity |
| deviation | Price deviation | (Current price - major-player cost) / major-player cost * 100% | Negative means below cost; positive means above cost |
| score | AI composite score | Range 0–100, composite of capital flow, technical indicators, etc. | Score <= 45 or >= 80: watchlist tokens; 45 < score < 55: observe tokens; 55 < score < 80: opportunity tokens |
| grade | Opportunity grade | Range 1–3; 3 is highest | Higher grade means higher risk |
| pushPrice | Entry push price | Price when the system first pushed this opportunity token | Use to calculate upside/downside after entry |
| gains | Upside move after push | (pushMaxPrice - pushPrice) / pushPrice * 100% | Maximum upside after push |
| declines | Drawdown after push | (pushPrice - pushMinPrice) / pushPrice * 100% | Maximum drawdown after push |
| alpha | Alpha signal | Boolean; indicates excess return potential | Pay more attention when true |
| fomo | FOMO signal | Boolean; indicates overheated market sentiment | When true, watch chase risk |
| fomoEscalation | FOMO escalation | Boolean; FOMO state escalates further | When true, risk increases significantly |
| active | 24h active addresses | On-chain addresses with trades in the past 24 hours | Reflects market participation |
| newly | 24h new addresses | Addresses that first held this token in the past 24 hours | Reflects new capital inflow |
| bullishRatio | Bullish sentiment ratio | Range 0–1, based on social analysis | Closer to 1 indicates a more bullish market |
| bearishRatio | Bearish sentiment ratio | Range 0–1, based on social analysis | Closer to 1 indicates a more bearish market |
| tradeInflow | Net trade inflow | Positive means inflow; negative means outflow | Sustained positive values indicate accumulation |
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 |
| 124 | 24 hours |
| 201 | 1 day |
| 207 | 7 days |
| 230 | 30 days |
Request example
json
{}cURL example (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinList' \
--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/getChanceCoinList" ^
--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": "23335", // Token ID
"symbol": "THE", // Token symbol
"price": "0.2792", // Current price
"maxPrice": "4.10318040169636", // Highest price
"minPrice": "0.07220387483514598", // Lowest price
"percentChange1h": "0.32799907", // 1-hour price change percentage
"percentChange24h": "1.41729409", // 24-hour price change percentage
"percentChange7d": "4.48765177", // 7-day price change percentage
"percentChange30d": "7.90282167", // 30-day price change percentage
"percentChange60d": "25.65261453", // 60-day price change percentage
"percentChange90d": "56.36890614", // 90-day price change percentage
"cost": "0.270901516998264831", // Cost price
"costChange": "0.0625", // Cost change
"deviation": "-1.418662", // Deviation
"marketCap": "36026970.954971075", // Market cap
"marketCapRanking": 312, // Market cap rank
"circulatingSupply": "128932942.41721758", // Circulating supply
"circulationRate": "39.535394", // Circulation rate
"active": "347", // Active addresses
"newly": "347", // New addresses
"tradeType": 1, // Trade type (1: spot, 2: futures, 3: delivery futures)
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15", // Time range
"timeParticleEnum": 15, // Time range enum value
"tradeInflow": "460.6252600000001", // Net trade inflow amount
"tradeAmount": "3213.5094600000007" // Trade amount
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-338.09664999999995",
"tradeAmount": "4455.511570000001"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-5145.618659999999",
"tradeAmount": "37250.337159999995"
}
// ... more items omitted
],
"updateTime": 1773016500000, // Update time
"pushPrice": "0.2621", // Push price
"pushMaxPrice": "0.2806", // Highest price after push
"gains": 0.0, // Upside move
"pushMinPrice": "0.2587", // Lowest price after push
"declines": 1.297215, // Drawdown
"score": 45.0, // Current score
"scoreChange": 10.0, // Score change
"grade": 2, // Grade
"alpha": false, // Alpha flag
"fomo": false, // FOMO flag
"fomoEscalation": false, // FOMO escalation flag
"bullishRatio": 1.0, // Bullish ratio
"bearishRatio": 0.0 // Bearish ratio
},
{
"vsTokenId": "1831",
"symbol": "BCH",
"price": "471.1",
"maxPrice": "4355.6201171875",
"minPrice": "75.0753135706",
"percentChange1h": "-0.01774485",
"percentChange24h": "2.29847208",
"percentChange7d": "2.79498224",
"percentChange30d": "-7.7764893",
"percentChange60d": "-24.54350443",
"percentChange90d": "-18.72153828",
"cost": "292.505855607332520866",
"costChange": "2.446914",
"deviation": "-35.698867",
"marketCap": "9404123107.056818",
"marketCapRanking": 11,
"circulatingSupply": "20006718.75",
"circulationRate": "95.270089",
"active": "22924",
"newly": "22924",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-22417.999600000003",
"tradeAmount": "68195.44840000001"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-30667.368100000003",
"tradeAmount": "107622.5285"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-100288.20520000004",
"tradeAmount": "1847100.6466"
}
// ... more items omitted
],
"updateTime": 1773025800000,
"pushPrice": "450.1",
"pushMaxPrice": "475.6",
"gains": 0.0,
"pushMinPrice": "442.6",
"declines": 1.666296,
"score": 65.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5455,
"bearishRatio": 0.0
},
{
"vsTokenId": "23635",
"symbol": "FORM",
"price": "0.29",
"maxPrice": "4.190275115870975",
"minPrice": "0.14300383150589102",
"percentChange1h": "1.00325051",
"percentChange24h": "8.34645515",
"percentChange7d": "0.43961778",
"percentChange30d": "48.34304224",
"percentChange60d": "-22.25867739",
"percentChange90d": "0.63458821",
"cost": "0.939513805854359157",
"costChange": "-0.253266",
"deviation": "218.155708",
"marketCap": "112311811.6419909",
"marketCapRanking": 155,
"circulatingSupply": "381867255.144574",
"circulationRate": "65.839182",
"active": "164",
"newly": "164",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-70934.94349000002",
"tradeAmount": "132642.78527"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-75774.15476000002",
"tradeAmount": "167235.10643999997"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-87347.62276",
"tradeAmount": "371051.104"
}
// ... more items omitted
],
"updateTime": 1773027600000,
"pushPrice": "0.2829",
"pushMaxPrice": "0.3109",
"gains": 0.0,
"pushMinPrice": "0.2627",
"declines": 7.140332000000001,
"score": 55.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5,
"bearishRatio": 0.0
}
// ... more items omitted
],
"requestId": "xxx-xxx-xxx"
}