Skip to content

Funds movement list

Description

Returns a list of tokens where major-player funds movement is detected on centralized exchanges for spot or futures trading.

Use cases:

  • Monitor tokens with active capital flow and short-term arbitrage potential during uptrends or range-bound markets
  • Discover tokens with abnormal fund flows

Tips:

  • Query this API when natural language input includes terms such as movement, bullish funds, or movement bullish
  • Query this API when natural language input includes upside opportunity or bullish tokens; label results as funds-movement bullish tokens

Data refresh: Updated every 5 minutes

Endpoint

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

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:

FieldTypeActual serialized typeDescription
updateTimelonglongUpdate time (millisecond timestamp)
tradeTypeintegerintegerTrade type (1: spot, 2: futures, 3: delivery futures)
vsTokenIdlongstringToken ID
symbolstringstringToken symbol
namestringstringToken name
startTimelonglongMovement start time (millisecond timestamp)
endTimelonglongMovement end time (millisecond timestamp)
number24hintegerintegerMovement count within 24h
numberNot24hintegerintegerMovement count outside 24h
pricenumberstringCurrent price (USD)
pushPricenumberstringMovement push price (USD)
gainsnumbernumberUpside move after push (%)
declinenumbernumberDrawdown after push (%)
percentChange24hnumberstring24-hour price change percentage
marketCapnumberstringMarket cap (USD)
alphabooleanbooleanAlpha signal flag
fomobooleanbooleanFOMO state flag
fomoEscalationbooleanbooleanFOMO escalation flag
bullishRationumbernumberBullish sentiment ratio

Field semantics

The following fields require additional business context:

FieldBusiness meaningRange / calculationUsage suggestion
startTimeMovement start timeStart of the funds movement periodUse to understand movement duration
endTimeMovement end timeEnd of the funds movement periodUse with startTime to judge movement cycle
number24hShort-term movementCount of fund movements detected in the last 24 hoursMore occurrences indicate more frequent movement
numberNot24hTrend movementFund movement count detected within 3 monthsMore occurrences indicate more frequent movement
pushPriceMovement push pricePrice when the system first pushed this movement tokenUse to calculate upside/downside after entry
alphaAlpha signalBoolean; indicates unusually active major players or high upside potentialPay more attention when true
fomoFOMO signalBoolean; indicates active market sentiment and possible trend continuationWhen true, upside may continue but watch chase risk
fomoEscalationFOMO escalationBoolean; overheated FOMO sentiment with possible sudden riskWhen true, risk increases significantly

Enum reference

tradeType — trade type

ValueMeaning
1Spot
2Perpetual futures
3Delivery futures

Request example

json
{}

cURL example (Linux/macOS)

bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getFundsCoinList' \
--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/getFundsCoinList" ^
--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": [
        {
            "updateTime": 1773395400000,               // Update time
            "tradeType": 2,                             // Trade type (1: spot, 2: futures, 3: delivery futures)
            "vsTokenId": "22974",                        // Token ID
            "symbol": "TAO",                             // Token symbol
            "name": "Bittensor",                         // Token name
            "startTime": 1773297600000,                  // Start time
            "endTime": 1773395400000,                    // End time
            "number24h": 7,                              // Count within 24h
            "numberNot24h": 1,                           // Count outside 24h
            "price": "237.5",                            // Price
            "pushPrice": "205.7",                        // Push price
            "gains": 19.202722,                          // Upside move
            "decline": 1.069519,                         // Drawdown
            "percentChange24h": "4.56494468",            // 24-hour price change percentage
            "marketCap": "2555201474.4451013",           // Market cap
            "alpha": true,                               // Alpha flag
            "fomo": false,                               // FOMO flag
            "fomoEscalation": false,                     // FOMO escalation flag
            "bullishRatio": 0.5569                       // Bullish sentiment ratio
        },
        {
            "updateTime": 1773400200000,
            "tradeType": 2,
            "vsTokenId": "1027",
            "symbol": "ETH",
            "name": "Ethereum",
            "startTime": 1773303600000,
            "endTime": 1773400200000,
            "number24h": 9,
            "numberNot24h": 11,
            "price": "2124.62",
            "pushPrice": "2049.61",
            "gains": 4.8394569999999995,
            "decline": 0.576695,
            "percentChange24h": "0.01534736",
            "marketCap": "256788544785.465",
            "alpha": true,
            "fomo": false,
            "fomoEscalation": false,
            "bullishRatio": 0.5077
        },
        {
            "updateTime": 1773395400000,
            "tradeType": 2,
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "startTime": 1773308700000,
            "endTime": 1773395400000,
            "number24h": 7,
            "numberNot24h": 8,
            "price": "72298",
            "pushPrice": "70297.65",
            "gains": 3.2409760000000003,
            "decline": 1.340457,
            "percentChange24h": "0.32026971",
            "marketCap": "1438236485462.7542",
            "alpha": false,
            "fomo": false,
            "fomoEscalation": false,
            "bullishRatio": 0.443
        }
        // ... more items omitted
    ],
    "requestId": "xxx-xxx-xxx"
}