主力行为指标

接口描述

取得BTC或ETH在特定时间范围内的，因主力动作可能影响到价格趋势的特色指标資料。

使用场景：

• 适用于对BTC和ETH的价格大趋势判断参考
• 适用于识别主力行为对价格的影响和整體价格趋势走向判断

資料更新频率：每5分鐘更新一次

請求URL

• 方法：POST
• 路径：/open/v1/indicator/getPriceMarketList

积分消耗

• 消耗积分：3

前置条件

取得 vsTokenId

条件	说明	取得方式
已有 vsTokenId	直接使用缓存的 vsTokenId，无需重复查询	上下文自动提取
未有 vsTokenId	调用 POST /vs-token/list 接口取得	前置接口调用

請求参数

参数通过請求體（Body）以 JSON 格式传递。

参数名	類型	必需	描述
vsTokenId	long	是	代幣 ID
startTime	long	否	开始时间（毫秒时间戳）
endTime	long	是	结束时间（毫秒时间戳）

回應欄位

仅展示 data 数组内每个对象的欄位结构：

欄位	類型	实际返回類型	描述
vsTokenId	long	string	代幣ID
symbol	string	string	代幣符号
date	long	long	时间（毫秒时间戳）
priceMarketType	integer	integer	价格趋势（1：上涨，2：下跌）

欄位业务含义

欄位	业务含义	使用建议
priceMarketType	价格趋势标记	1表示上涨阶段，2表示下跌阶段，用于判断当前价格走势

枚举值说明

priceMarketType - 价格趋势

值	含义
1	上涨
2	下跌

請求示例

{
    "vsTokenId": 1,           // 代幣 ID
    "startTime": 1770825600000, // 开始时间（时间戳）
    "endTime": 1773417600000    // 结束时间（时间戳）
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/indicator/getPriceMarketList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/indicator/getPriceMarketList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

成功回應示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                     // 代幣ID
            "symbol": "BTC",                      // 代幣符号
            "date": 1773158400000,                // 时间
            "priceMarketType": 1                   // 价格趋势（1：上涨，2：下跌）
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149400000,
            "priceMarketType": 1
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149100000,
            "priceMarketType": 1
        }
        // ... 更多資料省略
    ],
    "requestId": "xxx-xxx-xxx"
}