Market analysis list

API description

Query historical AI market analysis records by token (BTC/ETH), with time range filtering support.

Use cases:

• Precisely query historical market analysis records by token ID
• Batch fetch records for scenarios such as chart rendering
• Understand the AI composite signal and support/resistance conclusions for a specific token

Data refresh: every 5 minutes

Request URL

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

Credit consumption

• Credits per call: 3

Prerequisites

vsTokenId is required. You can get it from the token list API.

Request parameters

Pass parameters in the request body as JSON.

Parameter	Type	Required	Description
vsTokenId	long	Yes	Token ID
beginTime	string	No	Start time (millisecond timestamp)
endTime	string	No	End time (millisecond timestamp). Defaults to the current time if omitted
limit	integer	No	Number of records to return. Default 200, range 1-2000
language	string	No	Language. Supports zh-CN / zh-TW / en-US / vi-VN; default zh-CN

Response fields

Only fields inside each object of the data array:

Field	Type	Actual type	Description
vsTokenId	long	string	Token ID
symbol	string	string	Token symbol
icon	string	string	Token icon URL
price	number	string	Price at the time of analysis
signal	string	string	AI composite signal, such as HOLD / BUY / SELL
klineDiff	number	string	K-line change rate as a decimal, such as -0.003 for -0.3%
supports	array	array<string>	List of support prices as strings
resistances	array	array<string>	List of resistance prices as strings
analysis	string	string	AI analysis conclusion in the requested language
analysisTime	long	long	Analysis time (millisecond timestamp)

Field semantics

Field	Meaning	Guidance
vsTokenId	Unique token identifier	Corresponds to the request parameter and helps verify data ownership
symbol	Token trading symbol, such as BTC or ETH	Use for UI display
icon	Token icon URL	Use for frontend rendering
price	Token price when this analysis was published	Read together with analysis to understand the price context
signal	AI composite directional signal, such as HOLD / BUY / SELL	Quickly assess the overall AI bias
klineDiff	K-line change rate. Positive means up, negative means down	Use with signal to judge price momentum
supports	Key support prices calculated by AI	Watch the nearest support level to assist stop-loss decisions
resistances	Key resistance prices calculated by AI	Watch the nearest resistance level to assist take-profit decisions
analysis	AI composite analysis conclusion returned in the requested language (string)	Display directly to users without additional client-side language branching
analysisTime	Timestamp of the analysis record	Use for time-based sorting and display

Request example

{
    "vsTokenId": 1,                 // Token ID
    "beginTime": "1775732440000",   // Start time
    "endTime": "1775734240000",     // End time
    "limit": 200,                   // Number of records to return
    "language": "zh-CN"             // Language (optional, default zh-CN)
}

cURL example (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getMarketAnalysisList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "beginTime": "1775732440000",
    "endTime": "1775734240000",
    "limit": 200,
    "language": "zh-CN"
}'

cURL example (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getMarketAnalysisList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"beginTime\": \"1775732440000\",    \"endTime\": \"1775734240000\",    \"limit\": 200,    \"language\": \"zh-CN\"}"

Success response example

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // Token ID
            "symbol": "BTC",                                             // Token symbol
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // Token icon URL
            "price": "80573.75",                                         // Price at the time of analysis
            "signal": "HOLD",                                            // AI composite signal
            "klineDiff": "-0.00298373",                                  // K-line change rate (decimal)
            "supports": ["80434.275", "79980.475"],                      // List of support prices
            "resistances": ["80776.78", "81208.86"],                     // List of resistance prices
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // AI analysis conclusion (current language)
            "analysisTime": 1778837430000                                // Analysis time
        }
    ],
    "requestId": "2055219406232641536"
}