Opportunity token messages

Description

Returns AI tracking messages for tokens with upside potential in current market conditions, derived from multiple data dimensions.

Use cases:

• Query AI real-time tracking messages for tokens with upside opportunity in current conditions
• Understand major-player actions (entry, increase, decrease, exit, etc.)

Tips:

• Use together with the opportunity token list API; call this API only when querying signals for tokens in that list

Data refresh: Updated every 5 minutes

Endpoint

• Method: POST
• Path: /open/v1/ai/getChanceCoinMessageList

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
chanceMessageType	integer	integer	Prediction type
scoring	number	number	Score
grade	integer	integer	Grade
price	number	string	Token price
percentChange24h	number	number	24-hour price change
gains	number	number	Upside move
decline	number	number	Drawdown

Field semantics

Field	Business meaning	Usage suggestion
chanceMessageType	Opportunity message type	Identifies major-player action types such as entry, increase, decrease, exit, etc.
scoring	Opportunity score	Composite score for the signal; higher scores indicate stronger signals
grade	Opportunity grade	Signal tier for filtering important signals

Request example

{
    "vsTokenId": 23335      // Token ID
}

cURL example (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 23335
}'

cURL example (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 23335}"

Sample success response

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773071700000,       // Update time
            "vsTokenId": "23335",                // VS Token ID
            "symbol": "THE",                      // Token symbol
            "name": "THENA",                      // Token name
            "chanceMessageType": 30,                    // Prediction type
            "scoring": 0.0,                       // Score
            "grade": 2,                           // Grade
            "price": "0.2742",                    // Token price
            "percentChange24h": 6.18293206,       // 24-hour price change
            "gains": 5.0743990000000005,          // Upside move
            "decline": 0.363108                    // Drawdown
        },
        {
            "updateTime": 1773016500000,
            "vsTokenId": "23335",
            "symbol": "THE",
            "name": "THENA",
            "chanceMessageType": 5,
            "scoring": 45.0,
            "grade": 2,
            "price": "0.2621",
            "percentChange24h": 0.44075617,
            "gains": 0.0,
            "decline": 0.0
        }
    ],
    "requestId": "xxx-xxx-xxx"
}