majincheng

---
name: valuescan-skill-beta
description: ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。
version: 1.0.7
user-invocable: true
category: Data Analysis
license: MIT
homepage: https://beta.valuescan.io
dependencies:
  - node: 16.x
tags:
  - cryptocurrency
  - data analysis
  - blockchain
  - finance
documentation: |
  该 Skill 用于对加密货币市场进行分析，帮助用户识别资金流向、主力动向等信息。
support_email: [email protected]
website: https://beta.valuescan.io
credentials:
  api_key:
    description: 用于认证的 API 密钥
    required: true
  secret_key:
    description: 用于认证的 Secret 密钥
    required: true
---

# ValueScan API

加密货币主力资金流动向分析 API，追踪大户资金动向，让数据成为你的交易副驾驶。

## 使用场景示例

| 场景           | 通过 Skill 实现                                              |
| -------------- | ------------------------------------------------------------ |
| **行情信号**   | 用户问：“最近有哪些币出现主力异动？” →  调用 `资金异动列表` 返回结果。<br>用户问：“BTC主力资金异动信号有哪些？”→ Skill 调用 `资金异动消息` 返回结果。 |
| **行情信号**   | 用户问：“最近有哪些币可能上涨” →  调用 `资金异动列表`和  `机会代币列表`返回结果并说明场景     <br/>用户问：“BTC机会信号有哪些？”→ Skill 调用 `机会代币消息` 返回结果。 |
| **链上监控**   | 用户设置：“当 ETH 出现超过 1000 ETH 的大额转账时通知我。” →  调用 `大额交易` 实现实时监控。 |
| **投资决策**   | 用户问：“BTC 现在的压力位和支撑位在哪？” →  调用 `压力支撑位` 提供数据。 |
| **资金面分析** | 用户问：“过去一周，AI 板块的资金流向如何？” →  调用 `板块资金列表` 获取板块轮动数据。 |
| **地址分析**   | 用户提供地址：“帮我分析这个地址的持仓成本变化。” →  调用 `持仓趋势` 返回建仓成本曲线。 |

## 接口列表

### 基础数据

| 接口         | 用途                                              |
| ------------ | ------------------------------------------------- |
| 代币列表     | 搜索代币，获取对应的 `vsTokenId` 等基础标识信息。 |
| 代币基本信息 | 获取代币的实时价格、市值、`coinKey` 等详细信息。  |
| K线数据      | 支持多时间窗口的 K 线数据查询，用于技术分析。     |

### AI智选

AI综合多维度数据，追踪当前行情下的具有上涨机会或有下跌风险的代币，并实时追踪主力行为，提供实时追踪信号，辅助市场判断。

| 接口         | 用途                                                   |
| ------------ | ------------------------------------------------------ |
| 机会代币列表     | 追踪当前行情下具有上涨潜力的代币                       |
| 机会代币消息     | 上涨潜力币的主力动向实时信号（如吸筹、突破、出逃等）。 |
| 风险代币列表     | 当前行情下具有下跌风险趋势的代币                       |
| 风险代币消息     | 下跌风险币的主力动向实时信号（如派发、破位、反弹等）。 |
| 资金异动列表     | 上涨或震荡行情中资金活跃且具有短期套利潜力的代币       |
| 资金异动消息     | 短线/趋势异动的实时信号（如主力入场、抛压等）。        |

### 交易所主力资金监控

监控中心化交易所（现货/合约）的资金流数据，追踪主力动向。

| 接口           | 用途                                            |
| -------------- | ----------------------------------------------- |
| 实时资金积累       | 当日资金变化监控，反映主力实时流入/流出。       |
| 资金快照           | 最近100天的资金积累趋势，用于中长期资金面分析。 |
| 资金市值比         | 资金流入强度判断，辅助识别资金与市值匹配度。    |
| 板块资金列表       | 板块轮动资金监控，快速定位热点赛道。            |
| 板块代币资金       | 板块内龙头代币的实时资金积累数据。              |

### 链上主力资金监控

交易所的充/提资金监控，以及链上大户持仓成本变化监控，辅助主力行为追踪

| 接口     | 用途                                          |
| -------- | --------------------------------------------- |
| 代币流向     | 链上与交易所之间的资金交互监控（交易所的充提数据） |
| 主力成本变化趋势 | 大户平均持仓成本分析，识别主力建仓/出货位置。 |

### 市场指标

valuescan特色指标数据，对关键位置具有重要参考价值

| 接口         | 用途                                        |
| ------------ | ------------------------------------------- |
| 主力行为指标     | BTC/ETH 趋势判断，提供主力买卖行为信号。    |
| 压力支撑位     | 关键价格位置（支撑/压力）计算，辅助交易决策 |
| 社媒情绪        | 多空情绪分析，基于社交媒体热度与情绪指数。  |

### 链上大额交易

链上巨鲸交易监控，实时预警。

| 接口     | 用途                         |
| -------- | ---------------------------- |
| 大额交易     | 鲸鱼在多链上的转账交易监控。 |

### 链上持仓地址数据

| 接口           | 用途                                           |
| -------------- | ---------------------------------------------- |
| 持币地址           | 筹码集中度分析，查看地址数量与持仓分布。       |
| 余额趋势         | 指定地址的持仓变化历史。                       |
| 盈亏趋势         | 指定地址的投资绩效（盈利/亏损情况）。          |
| 持仓成本趋势 | 指定地址的建仓成本分析（均价变化）。           |
| 交易行为趋势 | 指定地址的交易活跃度（转账次数、频率）。       |

---

## 接口参考文件结构

`references/` 目录下的每个接口 JSON 文件均遵循统一结构，包含以下字段：

| 字段 | 类型 | 说明 |
|------|------|------|
| `name` | string | 接口中文名称 |
| `endpoint` | string | HTTP方法 + API路径（如 `POST /trade/getCoinTrade`） |
| `description` | string | 接口功能描述 |
| `credits_cost` | integer | 调用该接口消耗的积分数量 |
| `needToken` | boolean | 是否需要认证（true/false） |
| `use_case` | string | 业务使用场景说明，包含接口适用场景和使用建议 |
| `notes` | string | 调用注意事项和重要提醒 |
| `update_frequency` | string | 数据更新频率（如 `实时更新`） |
| `typeNote` | string | 类型转换说明（如部分数值字段实际返回字符串） |
| `params` | object | 请求参数定义，key 为参数名，value 含 `type`、`req`、`desc` |
| `response` | object | 响应字段定义，含 `type`、`actualType`、`desc` |
| `field_meta` | object | 字段业务含义，含 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议） |
| `enums` | object | 枚举值映射表，定义关键字段的可选值含义 |
| `example` | object | 请求/响应示例，含 `req`（请求体）和 `res`（响应体） |

### 字段类型说明

| type 值 | 说明 |
|---------|------|
| `long` / `integer` | 整数类型 |
| `number` | 数值类型（可能实际返回字符串） |
| `string` | 字符串类型 |
| `boolean` | 布尔类型 |
| `array` | 数组类型，含 `item` 定义元素结构 |

### 关键字段解析

#### 调用前必读字段

| 字段 | 说明 |
|------|------|
| `params` | 请求参数定义，`req: true` 表示必填参数，`req: false` 表示可选参数。调用接口前必须检查并填入所有必填参数。 |
| `notes` | 调用注意事项，包含接口使用限制、数据范围、业务约束等重要提示。必须阅读后再发起请求。 |
| `enums` | 枚举值映射表。某些字段（如 `tradeType`、`timeParticleEnum`）使用数字编码，需参照此表转换为实际含义，或从 `references/enums.json` 加载标准枚举定义。 |

#### 返回解读字段

| 字段 | 说明 |
|------|------|
| `response` | 响应字段定义，包含字段名、`type`（声明类型）、`actualType`（实际类型）、`desc`（字段含义）。用于解析返回数据的结构和含义。 |
| `field_meta` | 核心业务字段解读，提供字段的 `meaning`（业务定义）、`range`（取值范围）、`advice`（使用建议）。解读返回数据时优先参考此字段。 |
| `typeNote` | 类型转换说明。部分接口的数值字段声明为 `number` 但实际返回 `string`，使用前需注意类型转换。 |
| `example` | 请求/响应示例，包含 `req`（标准请求体格式）和 `res`（典型响应数据结构）。用于验证请求格式和理解返回数据。 |

---

## 快速开始

**Base URL**: `https://api-beta.valuescan.io/api/open/v1`

**认证**: HMAC-SHA256 签名

```

X-API-KEY: 你的API Key
X-TIMESTAMP: 13位毫秒时间戳
X-SIGN: HMAC-SHA256(secret=Secret Key, message=timestamp+body_json)

````

**API Key**: 访问 <https://beta.valuescan.io/dev-portal/home/> 注册：

```json
{ 
  "valuescanApiKey": "你的API Key", 
  "valuescanSecretKey": "你的Secret Key" 
}
````

**签名约束**: Raw Body 必须与请求体完全一致，禁止格式化 | 签名SDK: `sdk/README.md`

---

## 核心参数

| 参数                 | 说明                                       | 获取方式                                                                                                                                                    |
| ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `vsTokenId`        | 代币唯一标识                                   | 1. 调用 `/vs-token/list` 接口（参数 `search` 传代币符号如 `BTC`）；2. 从返回数据的 `id` 字段获取；3. 示例：`{ "id": 1, "symbol": "BTC", "name": "Bitcoin" }` 中 `id=1` 即为 `vsTokenId` |
| `coinKey`          | 链上代币标识（格式： `{symbol}_{contractAddress}`） | 1. 先通过 `vsTokenId` 调用 `/vs-token/detail` 接口；2. 从返回的 `chainAddresses[].coinKey` 获取；3. 示例：`BTC` 返回 `"BTC_BTC"`，`ETH` 返回 `"ETH_0x..."`（原生代币无合约地址）          |
| `address`          | 链上钱包地址                                   | 1. 调用 `持币地址` 接口获取某代币的持币地址列表；2. 或由用户直接提供；3. 格式为区块链标准地址（如 `0x...` 开头的以太坊地址）                                                                               |
| `timeParticleEnum` | 时间粒度编码                                   | 按分析周期选择：`5`=5分钟, `15`=15分钟, `101`=1小时, `104`=4小时, `124`=24小时, `201`=1天, `207`=7天, `230`=30天                                                             |
| `tradeType`        | 交易类型                                     | `1`=现货市场, `2`=合约/永续市场                                                                                                                                   |

### 参数获取示例

```
# 场景：用户查询 BTC 的主力资金数据

Step 1: 调用代币列表接口
POST /vs-token/list
Body: { "search": "btc" }
响应: { "id": 1, "symbol": "BTC", "name": "Bitcoin" }
      → 获取 vsTokenId = 1

Step 2: 调用代币详情（可选，获取coinKey）
POST /vs-token/detail
Body: { "vsTokenId": 1 }
响应: chainAddresses[0].coinKey = "BTC_BTC"
      → 获取 coinKey = "BTC_BTC"（用于链上数据查询）

Step 3: 使用 vsTokenId 调用目标接口
POST /trade/getCoinTrade
Body: { "vsTokenId": 1, "tradeType": 1 }
```

---

## 目录结构

```
valuescan-skill-beta/
├── SKILL.md                          # 技能文档
├── _meta.json                        # 元信息
├── references/                       # 接口参考文件
│   ├── enums.json                    # 通用枚举定义
│   │
│   ├── base/                         # 基础数据
│   │   ├── token-list.json           # 代币列表
│   │   ├── token-detail.json         # 代币详情
│   │   └── kline.json                # K线数据
│   │
│   ├── ai/                           # AI智选
│   │   ├── chance-coin-list.json     # 机会代币列表
│   │   ├── chance-coin-messages.json # 机会代币消息
│   │   ├── risk-coin-list.json       # 风险代币列表
│   │   ├── risk-coin-messages.json   # 风险代币消息
│   │   ├── funds-coin-list.json      # 资金异动列表
│   │   └── funds-coin-messages.json  # 资金异动消息
│   │
│   ├── fund/                         # 主力资金
│   │   ├── realtime-fund.json        # 实时资金积累
│   │   ├── fund-snapshot.json        # 资金快照
│   │   ├── marketcap-ratio.json      # 资金市值比
│   │   ├── coin-flow.json            # 代币流向
│   │   └── cost.json                 # 主力成本
│   │
│   ├── category/                     # 板块资金
│   │   ├── category-list.json        # 板块资金列表
│   │   └── category-tokens.json      # 板块代币资金
│   │
│   ├── indicator/                    # 市场指标
│   │   ├── price-market.json         # 主力行为指标
│   │   ├── dense-area.json           # 压力支撑位
│   │   └── sentiment.json            # 社媒情绪
│   │
│   └── chain/                        # 链上数据
│       ├── large-trade.json          # 大额交易
│       ├── holders.json              # 持币地址
│       ├── balance-trend.json        # 余额趋势
│       ├── profit-loss-trend.json    # 盈亏趋势
│       ├── hold-trend.json           # 持仓趋势
│       └── trade-count-trend.json    # 交易数量趋势
│
└── script/
    └── sdk/                          # 签名SDK
        ├── README.md                 # SDK说明
        └── vs_api_sign.js            # JavaScript签名
```

---

## 运行环境说明

| 项目    | 说明                                       |
| ----- | ---------------------------------------- |
| SDK依赖 | Node.js: 内置crypto/fetch，无需额外依赖           |
| 运行时要求 | Node.js 16+                              |
| 本地资源  | references/ 目录下的 JSON 文件仅供接口定义参考，运行时无需加载 |
| 安装安全性 | 本 Skill 无外部下载行为，所有依赖均为标准库或常用包            |

---

## API 文档

详细 API 文档请参考：[https://beta-claw.valuescan.io/zh-CN/](https://beta-claw.valuescan.io/zh-CN/)


FILE:_meta.json
{
  "name": "valuescan-skill-beta",
  "description": "ValueScan 加密货币主力资金流分析工具。支持资金异动监控、主力动向追踪、鲸鱼地址分析、板块轮动、机会/风险代币识别、大户成本分析。",
  "version": "1.0.7",
  "user-invocable": true,
  "homepage": "https://beta.valuescan.io",
  "credentials": {
    "api_key": {
      "description": "用于认证的 API 密钥",
      "required": true
    },
    "secret_key": {
      "description": "用于认证的 Secret 密钥",
      "required": true
    }
  },
  "auth": {
    "type": "custom",
    "headers": {
      "X-API-KEY": "valuescanApiKey",
      "X-TIMESTAMP": "timestamp",
      "X-SIGN": "signature"
    }
  },
  "api": {
    "base_url": "https://api-beta.valuescan.io/api/open/v1",
    "content_type": "application/json"
  },
  "signing": {
    "type": "hmac-sha256",
    "message": "timestamp+body_json",
    "secret": "valuescanSecretKey",
    "output": "hex"
  }
}
FILE:script/sdk/README.md
# ValueScan API SDK

## 使用步骤

**1. 配置 API Key**

访问 https://beta.valuescan.io/dev-portal/home/ 注册获取 API Key:

```json
{
  "valuescanApiKey": "你的API Key",
  "valuescanSecretKey": "你的Secret Key"
}
```
##  凭证说明

本技能需要 ValueScan API 凭证用于请求签名：

- 存储路径：`~/.openclaw/credentials/valuescan.json`
- 签名方式：HMAC-SHA256
- 数据用途：仅用于访问 ValueScan API，不会外传

本技能不会收集或上传用户敏感信息。

**2. SDK 调用**

| 场景 | 方法 |
|------|------|
| 发送请求 | `vsPost(path, data)` |
| 仅生成签名头 | `buildSignHeader(rawBody)` |

**3. 调用示例**

```javascript
const { vsPost } = require('./vs_api_sign');
const result = await vsPost('/api/open/v1/vs-token/list', {search: 'BTC'});
```

## 签名规范

- **timestamp**: 13位毫秒时间戳（有效期5分钟）
- **算法**: HMAC-SHA256(secret=Secret Key, message=timestamp + body_json)
- **请求头**: `X-API-KEY`, `X-TIMESTAMP`, `X-SIGN`
- **约束**: Raw Body 禁止格式化修改

FILE:script/sdk/vs_api_sign.js
/**
 * ValueScan API 签名 + 请求工具 (Node.js)
 * 依赖: Node.js 16+（内置crypto/fetch/url/fs，无需额外安装依赖）
 */
const crypto = require('crypto');
const fs = require('fs');
const path = require('path');
const os = require('os');
const { URL } = require('url');

const BASE_URL = 'https://api-beta.valuescan.io';

/**
 * 从配置文件读取 API Key 和 Secret Key
 * @returns {object} 包含 valuescanApiKey 和 valuescanSecretKey 的对象
 */
function loadCredentials() {
    const credPath = path.join(os.homedir(), '.openclaw', 'credentials', 'valuescan.json');
    
    if (!fs.existsSync(credPath)) {
        throw new Error(`配置文件不存在: credPath，请先创建该文件并配置 valuescanApiKey 和 valuescanSecretKey`);
    }
    
    try {
        const content = fs.readFileSync(credPath, 'utf8');
        const creds = JSON.parse(content);
        
        if (!creds.valuescanApiKey || !creds.valuescanSecretKey) {
            throw new Error('配置文件中缺少 valuescanApiKey 或 valuescanSecretKey 字段');
        }
        
        return creds;
    } catch (error) {
        if (error instanceof SyntaxError) {
            throw new Error(`配置文件 JSON 格式错误: credPath`);
        }
        throw error;
    }
}

/**
 * 生成符合规范的签名请求头
 * @param {string} rawBody POST原始请求体字符串（保持原始格式）
 * @returns {object} 包含X-API-KEY、X-TIMESTAMP、X-SIGN的请求头字典
 */
function buildSignHeader(rawBody) {
    const creds = loadCredentials();
    const apiKey = creds.valuescanApiKey;
    const secretKey = creds.valuescanSecretKey;

    const timestamp = Date.now().toString();
    const signContent = timestamp + rawBody;

    const hmac = crypto.createHmac('sha256', secretKey);
    hmac.update(signContent, 'utf8');
    const sign = hmac.digest('hex');

    return {
        'X-API-KEY': apiKey,
        'X-TIMESTAMP': timestamp,
        'X-SIGN': sign,
        'Content-Type': 'application/json; charset=utf-8'
    };
}

/**
 * 发送带签名的POST请求
 * @param {string} path API接口相对路径（如/api/open/v1/vs-token/list）
 * @param {object|string} data 请求数据（JSON对象/原始字符串）
 * @param {number} timeout 超时时间（毫秒），默认10000毫秒
 * @returns {Promise<object>} API响应结果（JSON对象）
 */
async function vsPost(path, data, timeout = 10000) {
    const rawBody = typeof data === 'object' ? JSON.stringify(data) : data;
    const fullUrl = new URL(path, BASE_URL).href;
    const headers = buildSignHeader(rawBody);

    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), timeout);

    try {
        const response = await fetch(fullUrl, {
            method: 'POST',
            headers: headers,
            body: rawBody,
            signal: controller.signal
        });

        clearTimeout(timeoutId);

        if (!response.ok) {
            throw new Error(`HTTP请求失败，状态码：response.status`);
        }

        return await response.json();
    } catch (error) {
        clearTimeout(timeoutId);
        if (error.name === 'AbortError') {
            throw new Error(`请求超时（timeoutms）：fullUrl`);
        }
        throw new Error(`请求失败：error.message`);
    }
}

module.exports = { buildSignHeader, vsPost };

// 调用示例
if (require.main === module) {
    const apiPath = '/api/open/v1/vs-token/list';
    const requestData = { search: 'BTC' };

    vsPost(apiPath, requestData)
        .then(result => {
            console.log('请求成功:', JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('请求失败:', error.message);
        });
}

FILE:references/enums.json
{
  "TradeType": {
    "description": "交易类型",
    "values": [
      { "value": "SPOT_GOODS", "code": 1, "description": "现货" },
      { "value": "CONTRACT", "code": 2, "description": "合约" }
    ]
  },
  "TimeParticleEnum": {
    "description": "时间粒度枚举",
    "values": [
      { "value": "m5", "code": 5, "description": "5分钟" },
      { "value": "m15", "code": 15, "description": "15分钟" },
      { "value": "m30", "code": 30, "description": "30分钟" },
      { "value": "H1", "code": 101, "description": "1小时" },
      { "value": "H2", "code": 102, "description": "2小时" },
      { "value": "H4", "code": 104, "description": "4小时" },
      { "value": "H6", "code": 106, "description": "6小时" },
      { "value": "H8", "code": 108, "description": "8小时" },
      { "value": "H12", "code": 112, "description": "12小时" },
      { "value": "H24", "code": 124, "description": "24小时" },
      { "value": "D1", "code": 201, "description": "1天" },
      { "value": "D2", "code": 202, "description": "2天" },
      { "value": "D3", "code": 203, "description": "3天" },
      { "value": "D5", "code": 205, "description": "5天" },
      { "value": "D7", "code": 207, "description": "7天" },
      { "value": "D10", "code": 210, "description": "10天" },
      { "value": "D15", "code": 215, "description": "15天" },
      { "value": "D20", "code": 220, "description": "20天" },
      { "value": "D30", "code": 230, "description": "30天" },
      { "value": "D40", "code": 240, "description": "40天" },
      { "value": "D50", "code": 250, "description": "50天" },
      { "value": "D60", "code": 260, "description": "60天" },
      { "value": "D90", "code": 290, "description": "90天" },
      { "value": "D120", "code": 2120, "description": "120天" },
      { "value": "D150", "code": 2150, "description": "150天" },
      { "value": "D180", "code": 2180, "description": "180天" },
      { "value": "M1", "code": 301, "description": "1个月" },
      { "value": "M2", "code": 302, "description": "2个月" },
      { "value": "M3", "code": 303, "description": "3个月" },
      { "value": "M4", "code": 304, "description": "4个月" },
      { "value": "M5", "code": 305, "description": "5个月" },
      { "value": "M6", "code": 306, "description": "6个月" },
      { "value": "M7", "code": 307, "description": "7个月" },
      { "value": "M8", "code": 308, "description": "8个月" },
      { "value": "M9", "code": 309, "description": "9个月" },
      { "value": "M10", "code": 310, "description": "10个月" },
      { "value": "M11", "code": 311, "description": "11个月" },
      { "value": "M12", "code": 312, "description": "12个月" },
      { "value": "Y1", "code": 401, "description": "1年" },
      { "value": "Y2", "code": 402, "description": "2年" },
      { "value": "Y3", "code": 403, "description": "3年" }
    ]
  },
  "BucketType": {
    "description": "K线桶类型",
    "values": [
      { "value": "S1", "code": "1s", "description": "1秒" },
      { "value": "S30", "code": "30s", "description": "30秒" },
      { "value": "M1", "code": "1m", "description": "1分钟" },
      { "value": "M3", "code": "3m", "description": "3分钟" },
      { "value": "M5", "code": "5m", "description": "5分钟" },
      { "value": "M15", "code": "15m", "description": "15分钟" },
      { "value": "M30", "code": "30m", "description": "30分钟" },
      { "value": "H1", "code": "1h", "description": "1小时" },
      { "value": "H2", "code": "2h", "description": "2小时" },
      { "value": "H4", "code": "4h", "description": "4小时" },
      { "value": "H8", "code": "8h", "description": "8小时" },
      { "value": "H12", "code": "12h", "description": "12小时" },
      { "value": "D1", "code": "1d", "description": "1天" },
      { "value": "D3", "code": "3d", "description": "3天" },
      { "value": "W1", "code": "1w", "description": "1周" },
      { "value": "M_1", "code": "1_m", "description": "1月" }
    ]
  },
  "KlineType": {
    "description": "K线类型（交易所）",
    "values": [
      { "value": "CMC", "code": "00", "description": "CMC交易所" },
      { "value": "BINANCE_SPOT", "code": "01", "description": "币安现货" },
      { "value": "BINANCE_CONTRACT", "code": "02", "description": "币安永续合约" },
      { "value": "BINANCE_CONTRACT_CURRENT", "code": "03", "description": "币安当季交割合约" },
      { "value": "BINANCE_CONTRACT_NEXT", "code": "04", "description": "币安次季交割合约" },
      { "value": "BINANCE_CONTRACT_TRADIFI_PERPETUAL", "code": "05", "description": "币安传统金融资产永续合约" }
    ]
  },
  "ChanceMessageType": {
    "description": "机会消息类型",
    "values": [
      { "value": "ESCAPE", "code": 2, "description": "主力出逃" },
      { "value": "INCREASE", "code": 3, "description": "主力增持" },
      { "value": "REDUCE", "code": 4, "description": "主力减持" },
      { "value": "ADD_CHANCE", "code": 5, "description": "主力入场" },
      { "value": "QUIT_CHANCE", "code": 6, "description": "追踪结束" },
      { "value": "GAINS", "code": 16, "description": "上涨止盈" },
      { "value": "DRAWDOWN", "code": 17, "description": "下跌止盈" },
      { "value": "QUIT_CHANCE2", "code": 18, "description": "追踪结束" },
      { "value": "INCREASE_HOLDINGS_ACCELERATED", "code": 28, "description": "主动增持加速" },
      { "value": "CHANCE_CAPITAL_PRESERVATION_REMINDER", "code": 30, "description": "保护本金" }
    ]
  },
  "FundsMovementType": {
    "description": "资金异动类型",
    "values": [
      { "value": "INFLOW_24H", "code": 1, "description": "短线行情异动" },
      { "value": "INFLOW_NOT_24H", "code": 2, "description": "趋势行情异动" },
      { "value": "STRANGE_MOVEMENT", "code": 3, "description": "Alpha" },
      { "value": "EXIT", "code": 4, "description": "追踪结束" },
      { "value": "VOLUME_PRICE_CRITERIA", "code": 5, "description": "FOMO" },
      { "value": "GAINS", "code": 6, "description": "上涨止盈" },
      { "value": "FOMO_ESCALATION", "code": 7, "description": "高风险预警" },
      { "value": "PROTECTION", "code": 8, "description": "保护本金" },
      { "value": "INFLOW_24H_FIRST", "code": 10, "description": "首次短线行情异动" },
      { "value": "INFLOW_NOT_24H_FIRST", "code": 11, "description": "首次趋势行情异动" },
      { "value": "STRANGE_MOVEMENT_FIRST", "code": 12, "description": "Alpha 首次" },
      { "value": "VOLUME_PRICE_CRITERIA_FIRST", "code": 13, "description": "首次 FOMO" }
    ]
  },
  "PriceMarketType": {
    "description": "价格市场类型",
    "values": [
      { "value": "RISE", "code": 1, "description": "上涨" },
      { "value": "DECLINE", "code": 2, "description": "下跌" }
    ]
  },
  "RiskMessageType": {
    "description": "风险消息类型",
    "values": [
      { "value": "SHIPPING", "code": 1, "description": "出货预警" },
      { "value": "ADD_RISK", "code": 7, "description": "下跌风险" },
      { "value": "QUIT_RISK", "code": 8, "description": "追踪结束" },
      { "value": "RISK_DECLINE", "code": 19, "description": "下跌止盈" },
      { "value": "RISK_DRAW_DOWN", "code": 21, "description": "风险回撤" },
      { "value": "RISK_REBOUND", "code": 22, "description": "下跌后反弹" },
      { "value": "RISK_TAKE_PROFIT", "code": 23, "description": "下跌止盈" },
      { "value": "ADD_TO_RISK", "code": 24, "description": "下跌风险" },
      { "value": "AND_INFLOW_24H", "code": 25, "description": "短线行情异动" },
      { "value": "AND_INFLOW_NOT_24H", "code": 27, "description": "趋势行情异动" },
      { "value": "REDUCED_HOLDINGS_ACCELERATED", "code": 29, "description": "持仓减少加速" },
      { "value": "RISK_CAPITAL_PRESERVATION_REMINDER", "code": 31, "description": "保护本金" }
    ]
  }
}

FILE:references/fund/marketcap-ratio.json
{
  "name": "资金市值比",
  "endpoint": "POST /trade/getCoinTradeInflowMarketCapRatio",
  "description": "提供代币实时主力资金与市值的比值查询，支持现货和合约两种交易类型",
  "credits_cost": 3,
  "needToken": true,
  "use_case": "适用于实时主力资金在市场的积累占比情况监测，适用于判断资金流入强度和市场关注度，适用于筛选资金关注度较高的代币标的",
  "update_frequency": "实时更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "marketCap": { "type": "number", "actualType": "string", "desc": "市值" },
    "spotTradeInflow": { "type": "number", "actualType": "string", "desc": "现货交易净流入金额" },
    "spotMarketCapRatio": { "type": "number", "actualType": "number", "desc": "现货资金市值比率" },
    "contractTradeInflow": { "type": "number", "actualType": "string", "desc": "合约交易净流入金额" },
    "contractMarketCapRatio": { "type": "number", "actualType": "number", "desc": "合约资金市值比率" },
    "totalTradeInflow": { "type": "number", "actualType": "string", "desc": "现货+合约交易净流入金额" },
    "totalMarketCapRatio": { "type": "number", "actualType": "number", "desc": "现货+合约资金市值比率" }
  },
  "example": {
    "req": { "vsTokenId": 1 },
    "res": {
      "code": 200,
      "data": {
        "updateTime": 1771001700000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "marketCap": "1380637213701.34",
        "spotTradeInflow": "6952062.18",
        "spotMarketCapRatio": 5.04E-4,
        "contractTradeInflow": "6952062.18",
        "contractMarketCapRatio": 5.04E-4,
        "totalTradeInflow": "13904124.37",
        "totalMarketCapRatio": 0.001
      }
    }
  }
}

FILE:references/fund/cost.json
{
  "name": "主力成本",
  "endpoint": "POST /trade/getCoinTradeCost",
  "description": "获取代币在BTC系列、EVM系列、波场等多链上的大户实时平均持仓成本数据",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于指定代币在链上的大户平均持仓成本数据获取，适用于主力行为分析，适用于评估当前价格相对主力成本的偏离程度",
  "update_frequency": "根据数据实时更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": false, "desc": "结束时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "price": { "type": "number", "actualType": "string", "desc": "价格(USD)" },
    "cost": { "type": "number", "actualType": "string", "desc": "主力成本(USD)" },
    "balance": { "type": "number", "actualType": "string", "desc": "余额" }
  },
  "field_meta": {
    "cost": { "meaning": "主力持仓成本", "advice": "根据大额交易加权计算的主力平均持仓成本，用于判断当前价格相对主力的盈亏状态" },
    "balance": { "meaning": "主力持仓余额", "advice": "反映大户的持仓数量变化，持续增加表示主力在吸筹" },
    "price": { "meaning": "代币市场价格", "advice": "与cost对比可计算价格偏离度：(price - cost) / cost * 100%" }
  },
  "example": {
    "req": { "vsTokenId": 1, "startTime": 1770825600000, "endTime": 1773417600000 },
    "res": {
      "code": 200,
      "data": [
        { "vsTokenId": "1", "symbol": "BTC", "name": "Bitcoin", "date": 1770825600000, "price": "67308.55", "cost": "60410.67", "balance": "3878063.59" }
      ]
    }
  }
}

FILE:references/fund/realtime-fund.json
{
  "name": "实时资金积累",
  "endpoint": "POST /trade/getCoinTrade",
  "description": "获取指定代币的实时资金数据（即实时净流入数据），以及当日的主力资金积累数据，包括代币的现货和合约交易",
  "credits_cost": 3,
  "needToken": true,
  "use_case": "适用于当日不同时间窗口的资金变化情况监控，适用于主力资金行为追踪，适用于实时资金流向分析和交易决策支撑",
  "notes": "查询日内主力资金为24h内的净流入最大值，查询主力资金为90d内净流入最大值；净流入为正表示主力流入（利多），净流入为负表示主力卖出（利空）；自然语言查询主力资金（未指定交易类型）时需要提供现货和合约的资金数据；自然语言查询主力分析、主力情况等综合语言需要调此接口",
  "update_frequency": "实时更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间（毫秒时间戳）" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "hasSpotGoods": { "type": "boolean", "actualType": "boolean", "desc": "是否存在现货数据" },
    "spotMaxInflow": { "type": "number", "actualType": "number", "desc": "现货主力资金积累(USD)" },
    "spotGoodsList": {
      "type": "array",
      "desc": "现货数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易量(USD)" },
        "tradeInflowChange": { "type": "number", "actualType": "number", "desc": "交易净流入变化率" },
        "tradeOut": { "type": "number", "actualType": "string", "desc": "交易流出金额(USD)" },
        "tradeIn": { "type": "number", "actualType": "string", "desc": "交易流入金额(USD)" }
      }
    },
    "hasContract": { "type": "boolean", "actualType": "boolean", "desc": "是否存在合约数据" },
    "contractMaxInflow": { "type": "number", "actualType": "number", "desc": "合约主力资金积累(USD)" },
    "contractList": {
      "type": "array",
      "desc": "合约数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易量(USD)" },
        "tradeInflowChange": { "type": "number", "actualType": "number", "desc": "交易净流入变化率" },
        "tradeOut": { "type": "number", "actualType": "string", "desc": "交易流出金额(USD)" },
        "tradeIn": { "type": "number", "actualType": "string", "desc": "交易流入金额(USD)" }
      }
    }
  },
  "field_meta": {
    "spotMaxInflow": { "meaning": "现货主力积累", "advice": "现货市场主力资金净流入的最大值，反映现货市场主力动向" },
    "contractMaxInflow": { "meaning": "合约主力积累", "advice": "合约市场主力资金净流入的最大值，反映合约市场主力动向" },
    "hasSpotGoods": { "meaning": "现货数据标识", "advice": "true表示有现货数据，false表示无现货数据" },
    "hasContract": { "meaning": "合约数据标识", "advice": "true表示有合约数据，false表示无合约数据" }
  },
  "example": {
    "req": { "vsTokenId": 1 },
    "res": {
      "code": 200,
      "data": {
        "updateTime": 1773220800000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "hasSpotGoods": true,
        "spotMaxInflow": 2588472.33,
        "spotGoodsList": [
          { "timeRange": "5m", "timeParticleEnum": 5, "tradeInflow": "1914106.28", "tradeAmount": "4389778.58", "tradeInflowChange": 373.39, "tradeOut": "2475814.56", "tradeIn": "4389920.85" }
        ],
        "hasContract": true,
        "contractMaxInflow": 17609356.02,
        "contractList": [
          { "timeRange": "5m", "timeParticleEnum": 5, "tradeInflow": "9098861.07", "tradeAmount": "32832991.12", "tradeInflowChange": 3.18, "tradeOut": "23734130.05", "tradeIn": "32832991.12" }
        ]
      }
    }
  }
}

FILE:references/fund/coin-flow.json
{
  "name": "代币流向",
  "endpoint": "POST /trade/getCoinTradeFlow",
  "description": "获取代币在链上的持仓地址与中心化交易所（CEX）之间的资金流入/流出及变化率数据",
  "credits_cost": 2,
  "needToken": true,
  "use_case": "适用于判断市场情绪和资金流向趋势，适用于链上资金与交易所资金交互分析",
  "update_frequency": "每天更新一次",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "coinTradeFlowDataV1Vos": {
      "type": "array",
      "desc": "交易所数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeIn": { "type": "number", "actualType": "string", "desc": "交易流入金额(USD)" },
        "tradeOut": { "type": "number", "actualType": "string", "desc": "交易流出金额(USD)" },
        "tradeInNumber": { "type": "number", "actualType": "string", "desc": "交易流入数量" },
        "tradeOutNumber": { "type": "number", "actualType": "string", "desc": "交易流出数量" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易量(USD)" },
        "tradeInflowChange": { "type": "number", "actualType": "number", "desc": "交易净流入变化率" }
      }
    }
  },
  "field_meta": {
    "tradeInflow": { "meaning": "交易净流入", "advice": "正值表示资金流入，负值表示资金流出，持续正值表示主力在吸筹" },
    "tradeInflowChange": { "meaning": "净流入变化率", "advice": "反映资金流入速度的增减，正值加速流入，负值加速流出" }
  },
  "example": {
    "req": { "vsTokenId": 1 },
    "res": {
      "code": 200,
      "data": {
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "coinTradeFlowDataV1Vos": [
          { "timeRange": "H1", "timeParticleEnum": 101, "tradeIn": "18287486.34", "tradeOut": "20431186.01", "tradeInNumber": "261.06", "tradeOutNumber": "292.25", "tradeInflow": "-2143699.66", "tradeAmount": "38718672.35", "tradeInflowChange": -1.05 }
        ]
      }
    }
  }
}

FILE:references/fund/fund-snapshot.json
{
  "name": "资金快照",
  "endpoint": "POST /trade/getCoinTradeSnapshot",
  "description": "获取指定代币在最近100天内任意时间点的资金积累数据，以及100天内指定时间的主力资金积累数据",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于短期内代币在不同时间点下的资金积累情况数据获取，适用于判断资金积累在一段时间内的变化趋势，适用于历史资金行为回溯分析",
  "notes": "仅查询某天的数据但未指定具体时间点，默认查询UTC+8时间点的数据；自然语言查询主力资金趋势等综合语言需要调此接口",
  "update_frequency": "定时快照",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "date": { "type": "long", "req": true, "desc": "指定日期（毫秒时间戳）" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "hasSpotGoods": { "type": "boolean", "actualType": "boolean", "desc": "是否存在现货数据" },
    "spotMaxInflow": { "type": "number", "actualType": "string", "desc": "现货主力资金积累" },
    "spotGoodsList": {
      "type": "array",
      "desc": "现货数据",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易量(USD)" }
      }
    },
    "hasContract": { "type": "boolean", "actualType": "boolean", "desc": "是否存在合约数据" },
    "contractMaxInflow": { "type": "number", "actualType": "string", "desc": "合约主力资金积累" },
    "contractList": {
      "type": "array",
      "desc": "合约数据",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易量(USD)" }
      }
    }
  },
  "example": {
    "req": { "vsTokenId": 1, "date": 1773654600000 },
    "res": {
      "code": 200,
      "data": {
        "updateTime": 1773654600000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "hasSpotGoods": true,
        "spotMaxInflow": "173206257.99",
        "spotGoodsList": [
          { "timeRange": "m5", "timeParticleEnum": 5, "tradeInflow": "973669.05", "tradeAmount": "4176136.90" },
          { "timeRange": "m15", "timeParticleEnum": 15, "tradeInflow": "1531287.20", "tradeAmount": "11822696.07" },
          { "timeRange": "m30", "timeParticleEnum": 30, "tradeInflow": "2668474.96", "tradeAmount": "25890934.62" }
        ],
        "hasContract": true,
        "contractMaxInflow": "5115857220.79",
        "contractList": [
          { "timeRange": "m5", "timeParticleEnum": 5, "tradeInflow": "7412113.46", "tradeAmount": "33097685.52" },
          { "timeRange": "m15", "timeParticleEnum": 15, "tradeInflow": "5682104.78", "tradeAmount": "69809754.71" },
          { "timeRange": "m30", "timeParticleEnum": 30, "tradeInflow": "-6355722.27", "tradeAmount": "183233913.61" }
        ]
      }
    }
  }
}

FILE:references/base/kline.json
{
  "name": "K 线数据",
  "endpoint": "POST /trade/kline/getTradeKLineList",
  "description": "获取K线数据，可查询指定代币（仅支持USDT交易对）和指定时间段内不超过1000条的K线数据",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于查询不同时间窗口类型的K线数据查询，适用于结合价格K线判断买卖时机",
  "update_frequency": "根据bucketType实时更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "bucketType": { "type": "string", "req": true, "desc": "K线时间窗口类型(5m/15m/30m/1h/4h/1d/1w)" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "结束时间（毫秒时间戳）" },
    "size": { "type": "integer", "req": false, "desc": "查询记录数，默认360条，最大不超过1000条" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "klineType": { "type": "string", "actualType": "string", "desc": "K线类型" },
    "klineData": {
      "type": "array",
      "desc": "K线数据",
      "item": {
        "time": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
        "open": { "type": "number", "actualType": "string", "desc": "开盘价" },
        "close": { "type": "number", "actualType": "string", "desc": "收盘价" },
        "high": { "type": "number", "actualType": "string", "desc": "最高价" },
        "low": { "type": "number", "actualType": "string", "desc": "最低价" },
        "volume": { "type": "number", "actualType": "string", "desc": "成交量" },
        "amount": { "type": "number", "actualType": "string", "desc": "成交额(USD)" }
      }
    }
  },
  "enums": {
    "bucketType": {
      "5m": "5分钟",
      "15m": "15分钟",
      "30m": "30分钟",
      "1h": "1小时",
      "4h": "4小时",
      "1d": "1天",
      "1w": "1周"
    }
  },
  "example": {
    "req": { "vsTokenId": 1, "bucketType": "5m", "endTime": 1773478632535, "size": 20 },
    "res": {
      "code": 200,
      "data": {
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "klineType": "01",
        "klineData": [
          { "time": 1773478200000, "open": "70544.92", "close": "70594.48", "high": "70594.49", "low": "70536.58", "volume": "20.54", "amount": "1449509.94" }
        ]
      }
    }
  }
}

FILE:references/base/token-detail.json
{
  "name": "代币详情",
  "endpoint": "POST /vs-token/detail",
  "description": "获取指定代币的基础信息，包括市场信息，链上基本信息，行情基本信息等",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于代币的通用信息查询，适用于获取代币的完整信息，包括价格、市值、供应量等，适用于获取coinKey（调用链上数据接口的必要参数）",
  "important": "chainAddresses数组中包含该代币在不同区块链上的coinKey，如需查询链上持仓地址、余额趋势等数据，需让用户选择目标链并缓存对应的coinKey",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "oldSymbol": { "type": "string", "actualType": "string", "desc": "改名前的symbol" },
    "price": { "type": "number", "actualType": "string", "desc": "当前价格(USD)" },
    "highPrice": { "type": "number", "actualType": "string", "desc": "历史最高价(USD)" },
    "lowPrice": { "type": "number", "actualType": "string", "desc": "历史最低价(USD)" },
    "marketCapDominance": { "type": "number", "actualType": "string", "desc": "市值占比(%)" },
    "volume24h": { "type": "number", "actualType": "string", "desc": "24H交易量(USD)" },
    "volumeChange24h": { "type": "number", "actualType": "string", "desc": "24H交易量变化率(%)" },
    "percentChange1h": { "type": "number", "actualType": "string", "desc": "1小时涨跌幅(%)" },
    "percentChange24h": { "type": "number", "actualType": "string", "desc": "24小时涨跌幅(%)" },
    "percentChange7d": { "type": "number", "actualType": "string", "desc": "7天涨跌幅(%)" },
    "percentChange30d": { "type": "number", "actualType": "string", "desc": "30天涨跌幅(%)" },
    "percentChange60d": { "type": "number", "actualType": "string", "desc": "60天涨跌幅(%)" },
    "percentChange90d": { "type": "number", "actualType": "string", "desc": "90天涨跌幅(%)" },
    "marketCap": { "type": "number", "actualType": "string", "desc": "市值(USD)" },
    "totalSupply": { "type": "number", "actualType": "string", "desc": "总供应量" },
    "circulationSupply": { "type": "number", "actualType": "string", "desc": "流通量" },
    "maxSupply": { "type": "number", "actualType": "string", "desc": "最大供应量" },
    "cost": { "type": "number", "actualType": "string", "desc": "链上持仓成本(USD)" },
    "chainAddresses": {
      "type": "array",
      "desc": "各个链上信息",
      "item": {
        "contractAddress": { "type": "string", "actualType": "string", "desc": "合约地址" },
        "chainName": { "type": "string", "actualType": "string", "desc": "链名" },
        "holderCount": { "type": "integer", "actualType": "string", "desc": "持仓地址数" },
        "transCount": { "type": "integer", "actualType": "string", "desc": "交易笔数" },
        "issueDate": { "type": "long", "actualType": "long", "desc": "发行时间（毫秒时间戳）" },
        "precision": { "type": "string", "actualType": "string", "desc": "精度" },
        "totalSupply": { "type": "string", "actualType": "string", "desc": "该链上供应量" },
        "coinKey": { "type": "string", "actualType": "string", "desc": "链上代币标识（调用链上数据接口的必要参数）" }
      }
    }
  },
  "example": {
    "req": { "vsTokenId": 1 },
    "res": {
      "code": 200,
      "data": {
        "vsTokenId": "1",
        "name": "Bitcoin",
        "symbol": "BTC",
        "oldSymbol": "",
        "price": "70559.18",
        "highPrice": "126198.07",
        "lowPrice": "0.04864654",
        "marketCapDominance": "",
        "volume24h": "54389029990.50",
        "volumeChange24h": "15.6056",
        "percentChange1h": "-0.09",
        "percentChange24h": "-1.29",
        "percentChange7d": "3.96",
        "percentChange30d": "5.35",
        "percentChange60d": "-23.17",
        "percentChange90d": "-21.71",
        "marketCap": "1412725749093.27",
        "totalSupply": "20001887",
        "circulationSupply": "20001887",
        "maxSupply": "21000000",
        "cost": "60515.83",
        "chainAddresses": [
          {
            "contractAddress": "BTC",
            "chainName": "BTC",
            "holderCount": "55905596",
            "transCount": "1322741358",
            "issueDate": 1230998400000,
            "precision": "8",
            "totalSupply": "20001892",
            "coinKey": "BTC_BTC"
          }
        ]
      }
    }
  }
}

FILE:references/base/token-list.json
{
  "name": "代币列表",
  "endpoint": "POST /vs-token/list",
  "description": "获取ValueScan支持的代币列表，支持按代币全称或代币简称进行模糊搜索",
  "credits_cost": 1,
  "needToken": false,
  "use_case": "这是基础接口，用于获取代币的vsTokenId，该ID是调用其他代币相关接口的必要参数。重要提示：当用户输入代币名称时，若存在多个同名或相近的代币（如不同链、不同标准），需引导用户选择目标代币，并缓存代币名称与vsTokenId的对应关系，以便后续接口调用时直接引用",
  "params": {
    "search": { "type": "string", "req": false, "desc": "搜索关键字（符号，支持模糊匹配），最大长度100字符，大小写不敏感" }
  },
  "response": {
    "id": { "type": "long", "actualType": "long", "desc": "代币ID（即vsTokenId，用于其他接口调用）" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号（如BTC, ETH）" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称（如Bitcoin, Ethereum）" }
  },
  "example": {
    "req": { "search": "btc" },
    "res": {
      "code": 200,
      "data": [
        { "id": 1, "symbol": "BTC", "name": "Bitcoin" },
        { "id": 33652, "symbol": "LBTC", "name": "Lombard Staked BTC" }
      ]
    }
  }
}

FILE:references/ai/chance-coin-messages.json
{
  "name": "机会代币消息列表",
  "endpoint": "POST /ai/getChanceCoinMessageList",
  "description": "获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据",
  "credits_cost": 3,
  "needToken": true,
  "use_case": "适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询，适用于了解主力动作（入场、增持、减持、出逃等）",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "chanceMessageType": { "type": "integer", "actualType": "integer", "desc": "预测类型" },
    "scoring": { "type": "number", "actualType": "number", "desc": "得分" },
    "grade": { "type": "integer", "actualType": "integer", "desc": "等级" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" },
    "percentChange24h": { "type": "number", "actualType": "number", "desc": "24小时涨跌幅" },
    "gains": { "type": "number", "actualType": "number", "desc": "涨幅" },
    "decline": { "type": "number", "actualType": "number", "desc": "跌幅" }
  },
  "field_meta": {
    "chanceMessageType": { "meaning": "机会消息类型", "advice": "标识主力动作类型，如入场、增持、减持、出逃等" },
    "scoring": { "meaning": "机会得分", "advice": "该信号的综合评分，分数越高信号越强" },
    "grade": { "meaning": "机会等级", "advice": "信号等级划分，用于筛选重要信号" }
  },
  "example": {
    "req": { "vsTokenId": 23335 },
    "res": {
      "code": 200,
      "data": [
        {
          "updateTime": 1773071700000,
          "vsTokenId": "23335",
          "symbol": "THE",
          "name": "THENA",
          "chanceMessageType": 30,
          "scoring": 0.0,
          "grade": 2,
          "price": "0.2742",
          "percentChange24h": 6.18,
          "gains": 5.07,
          "decline": 0.36
        }
      ]
    }
  }
}

FILE:references/ai/risk-coin-list.json
{
  "name": "风险代币列表",
  "endpoint": "POST /ai/getRiskCoinList",
  "description": "获取AI通过多维度数据，追踪到当前行情下具有下跌风险趋势的代币列表",
  "credits_cost": 3,
  "needToken": false,
  "use_case": "适用于当前行情下存在下跌行情风险的代币查询，适用于风险预警和持仓规避参考",
  "update_frequency": "每 5 分钟更新一次",
  "params": {},
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "币种符号" },
    "price": { "type": "number", "actualType": "string", "desc": "当前价格" },
    "maxPrice": { "type": "number", "actualType": "string", "desc": "最高价格" },
    "minPrice": { "type": "number", "actualType": "string", "desc": "最低价格" },
    "percentChange1h": { "type": "number", "actualType": "string", "desc": "1小时价格变化百分比" },
    "percentChange24h": { "type": "number", "actualType": "string", "desc": "24小时价格变化百分比" },
    "percentChange7d": { "type": "number", "actualType": "string", "desc": "7天价格变化百分比" },
    "percentChange30d": { "type": "number", "actualType": "string", "desc": "30天价格变化百分比" },
    "percentChange60d": { "type": "number", "actualType": "string", "desc": "60天价格变化百分比" },
    "percentChange90d": { "type": "number", "actualType": "string", "desc": "90天价格变化百分比" },
    "cost": { "type": "number", "actualType": "string", "desc": "成本价格" },
    "costChange": { "type": "number", "actualType": "string", "desc": "成本变化" },
    "deviation": { "type": "number", "actualType": "string", "desc": "偏离度" },
    "marketCap": { "type": "number", "actualType": "string", "desc": "市值" },
    "marketCapRanking": { "type": "integer", "actualType": "integer", "desc": "市值排名" },
    "circulatingSupply": { "type": "number", "actualType": "string", "desc": "流通供应量" },
    "circulationRate": { "type": "number", "actualType": "string", "desc": "流通率" },
    "active": { "type": "integer", "actualType": "string", "desc": "活跃地址" },
    "newly": { "type": "integer", "actualType": "string", "desc": "新增地址" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货 2:合约 3:交割合约）" },
    "chanceCoinTradeDataV1Vos": {
      "type": "array",
      "desc": "交易时间数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围标识（如m15, H4）" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "时间粒度枚举值" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易总金额(USD)" }
      }
    },
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "pushPrice": { "type": "number", "actualType": "string", "desc": "推送价格" },
    "pushMaxPrice": { "type": "number", "actualType": "string", "desc": "推送最高价" },
    "gains": { "type": "number", "actualType": "number", "desc": "回撤" },
    "pushMinPrice": { "type": "number", "actualType": "string", "desc": "推送最低价" },
    "declines": { "type": "number", "actualType": "number", "desc": "跌幅" },
    "score": { "type": "number", "actualType": "number", "desc": "当前评分" },
    "bullishRatio": { "type": "number", "actualType": "number", "desc": "看涨比例" },
    "bearishRatio": { "type": "number", "actualType": "number", "desc": "看跌比例" }
  },
  "field_meta": {
    "cost": { "meaning": "主力成本价格", "range": "根据大额交易加权计算的主力持仓成本", "advice": "当前价格高于成本价时主力可能获利了结" },
    "deviation": { "meaning": "价格偏离度", "range": "(当前价格 - 主力成本) / 主力成本 * 100%", "advice": "正值过大时需警惕回调风险" },
    "score": { "meaning": "AI风险评分", "range": "0-100，基于资金流、技术指标等综合计算", "advice": "评分<=45或>=80:待观察代币；45<评分<75:观察代币；75<评分<80：下跌风险代币" },
    "pushPrice": { "meaning": "风险推送价格", "range": "系统首次推送该风险代币时的价格", "advice": "用于计算推送后的涨跌幅" },
    "declines": { "meaning": "推送后跌幅", "range": "(pushPrice - pushMinPrice) / pushPrice * 100%", "advice": "验证风险预警的准确性" },
    "tradeInflow": { "meaning": "交易净流入", "range": "正值为资金流入，负值为资金流出", "advice": "持续负值表示主力在出货" }
  },
  "enums": {
    "tradeType": { "1": "现货", "2": "合约（永续）", "3": "交割合约" },
    "timeParticleEnum": { "5": "5分钟", "15": "15分钟", "30": "30分钟", "101": "1小时", "104": "4小时", "106": "6小时", "124": "24小时", "201": "1天", "202": "2天", "207": "7天", "230": "30天" }
  },
  "example": {
    "req": {},
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "38178",
          "symbol": "TRUTH",
          "price": "0.0094",
          "maxPrice": "0.0502",
          "minPrice": "0.0084",
          "percentChange1h": "-0.42",
          "percentChange24h": "-0.22",
          "percentChange7d": "-0.64",
          "percentChange30d": "-33.89",
          "percentChange60d": "-36.71",
          "percentChange90d": "-52.50",
          "cost": "",
          "costChange": "",
          "deviation": "",
          "marketCap": "19433307.40",
          "marketCapRanking": 427,
          "circulatingSupply": "2085305300",
          "circulationRate": "20.85",
          "active": "",
          "newly": "",
          "tradeType": 2,
          "updateTime": 1771287000000,
          "pushPrice": "0.0157",
          "pushMaxPrice": "0.0163",
          "gains": 0.0,
          "pushMinPrice": "0.0088",
          "declines": 43.77,
          "score": 36.5,
          "bullishRatio": "",
          "bearishRatio": ""
        }
      ]
    }
  }
}

FILE:references/ai/funds-coin-list.json
{
  "name": "资金异动代币列表",
  "endpoint": "POST /ai/getFundsCoinList",
  "description": "获取对指定代币在中心化交易所上，监控到现货或合约交易存在主力资金异动的代币列表",
  "credits_cost": 3,
  "needToken": false,
  "use_case": "适用于实时监控在上涨或震荡行情中资金活跃且具有短期套利潜力的代币查询，适用于发现异常资金流动的代币",
  "notes": "自然语言输入异动、资金看涨、异动看涨等词语时查询此接口；自然语言输入上涨机会、看涨代币等语言时可查询此接口，返回结果需注明资金异动看涨代币",
  "update_frequency": "实时更新",
  "params": {},
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货 2:合约 3:交割合约）" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "交易符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "startTime": { "type": "long", "actualType": "long", "desc": "开始时间" },
    "endTime": { "type": "long", "actualType": "long", "desc": "结束时间" },
    "number24h": { "type": "integer", "actualType": "integer", "desc": "24小时内的数量" },
    "numberNot24h": { "type": "integer", "actualType": "integer", "desc": "非24小时内的数量" },
    "price": { "type": "number", "actualType": "string", "desc": "价格" },
    "pushPrice": { "type": "number", "actualType": "string", "desc": "开始价格" },
    "gains": { "type": "number", "actualType": "number", "desc": "涨幅" },
    "decline": { "type": "number", "actualType": "number", "desc": "推送后跌幅(%)" },
    "percentChange24h": { "type": "number", "actualType": "string", "desc": "24小时价格变化百分比" },
    "marketCap": { "type": "number", "actualType": "string", "desc": "市值" },
    "alpha": { "type": "boolean", "actualType": "boolean", "desc": "是否Alpha" },
    "fomo": { "type": "boolean", "actualType": "boolean", "desc": "是否Fomo" },
    "fomoEscalation": { "type": "boolean", "actualType": "boolean", "desc": "是否Fomo加剧" },
    "bullishRatio": { "type": "number", "actualType": "number", "desc": "看涨情绪比例" }
  },
  "field_meta": {
    "startTime": { "meaning": "异动开始时间", "range": "资金异动周期的起始时间", "advice": "用于了解异动持续时长" },
    "endTime": { "meaning": "异动结束时间", "range": "资金异动周期的结束时间", "advice": "与startTime配合判断异动周期" },
    "number24h": { "meaning": "短线行情异动", "range": "最近24小时内资金的异动次数检测", "advice": "次数越多表示异动越频繁" },
    "numberNot24h": { "meaning": "趋势行情异动", "range": "3个月内的资金异动次数检测", "advice": "次数越多表示异动越频繁" },
    "pushPrice": { "meaning": "异动推送价格", "range": "系统首次推送该异动代币时的价格", "advice": "用于计算入场后的涨跌幅" },
    "alpha": { "meaning": "Alpha信号", "range": "布尔值，表示主力异常活跃或上涨可能高", "advice": "true时关注度应更高" },
    "fomo": { "meaning": "FOMO信号", "range": "布尔值，表示市场情绪活跃，上涨趋势可能延续", "advice": "true时上涨延续可能性高，但需注意追高风险" },
    "fomoEscalation": { "meaning": "FOMO加剧", "range": "布尔值，FOMO市场情绪过热，可能有突发风险", "advice": "true时风险显著增加" }
  },
  "enums": {
    "tradeType": { "1": "现货", "2": "合约（永续）", "3": "交割合约" }
  },
  "example": {
    "req": {},
    "res": {
      "code": 200,
      "data": [
        {
          "updateTime": 1773395400000,
          "tradeType": 2,
          "vsTokenId": "22974",
          "symbol": "TAO",
          "name": "Bittensor",
          "startTime": 1773297600000,
          "endTime": 1773395400000,
          "number24h": 7,
          "numberNot24h": 1,
          "price": "237.5",
          "pushPrice": "205.7",
          "gains": 19.20,
          "declines": 1.07,
          "percentChange24h": "4.56",
          "marketCap": "2555201474.45",
          "alpha": true,
          "fomo": false,
          "fomoEscalation": false,
          "bullishRatio": 0.56
        }
      ]
    }
  }
}

FILE:references/ai/funds-coin-messages.json
{
  "name": "资金异动代币消息列表",
  "endpoint": "POST /ai/getFundsCoinMessageList",
  "description": "获取对指定代币在中心化交易所上，现货或合约交易的主力资金异动的监控消息记录",
  "credits_cost": 3,
  "needToken": true,
  "use_case": "适用于资金异动监控列表下的代币，在AI实时追踪过程中的消息查询，适用于查看历史资金异动信号记录，包括但不限于短线/趋势行情异动、Alpha、FOMO、止盈、止损等",
  "notes": "信号类型需展示名称，出现多个alpha，fomo等消息时，统计各自出现的次数，同时出现时特别提醒；自然语言查询异动代币后，或查询异动信号，调用此接口；与资金异动代币列表接口配合使用，资金异动代币里的代币信号查询才调用此接口",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "tradeType": { "type": "integer", "req": true, "desc": "交易类型（1:现货, 2:合约）" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "名称" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货; 2:合约; 3:交割合约）" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" },
    "percentChange24h": { "type": "number", "actualType": "number", "desc": "24小时涨跌幅" },
    "fundsMovementType": { "type": "integer", "actualType": "integer", "desc": "资金流动类型" }
  },
  "field_meta": {
    "fundsMovementType": { "meaning": "资金异动类型", "advice": "标识资金异动类型，如短线行情异动、趋势行情异动、Alpha等，同一时间多个类型时，可特别提醒，信号类型的对应关系不展示" }
  },
  "example": {
    "req": { "vsTokenId": 22974, "tradeType": 1 },
    "res": {
      "code": 200,
      "data": [
        {
          "updateTime": 1773395700000,
          "vsTokenId": "22974",
          "symbol": "TAO",
          "name": "Bittensor",
          "tradeType": 1,
          "price": "241.4",
          "percentChange24h": 15.36,
          "fundsMovementType": 6
        }
      ]
    }
  }
}

FILE:references/ai/chance-coin-list.json
{
  "name": "机会代币列表",
  "endpoint": "POST /ai/getChanceCoinList",
  "description": "获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表",
  "credits_cost": 3,
  "needToken": false,
  "use_case": "适用于当前行情下存在上涨行情机会的代币筛选和查询，适用于中短线交易者寻找具有上涨潜力的代币标的，适用于趋势跟踪策略中识别潜在上涨机会",
  "update_frequency": "每 5 分钟更新一次",
  "typeNote": "部分数值字段实际返回为字符串类型，使用时请注意类型转换",
  "params": {},
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "币种符号" },
    "price": { "type": "number", "actualType": "string", "desc": "当前价格(USD)" },
    "maxPrice": { "type": "number", "actualType": "string", "desc": "历史最高价格(USD)" },
    "minPrice": { "type": "number", "actualType": "string", "desc": "历史最低价格(USD)" },
    "percentChange1h": { "type": "number", "actualType": "string", "desc": "1小时价格变化百分比" },
    "percentChange24h": { "type": "number", "actualType": "string", "desc": "24小时价格变化百分比" },
    "percentChange7d": { "type": "number", "actualType": "string", "desc": "7天价格变化百分比" },
    "percentChange30d": { "type": "number", "actualType": "string", "desc": "30天价格变化百分比" },
    "percentChange60d": { "type": "number", "actualType": "string", "desc": "60天价格变化百分比" },
    "percentChange90d": { "type": "number", "actualType": "string", "desc": "90天价格变化百分比" },
    "cost": { "type": "number", "actualType": "string", "desc": "主力成本价格(USD)" },
    "costChange": { "type": "number", "actualType": "string", "desc": "成本变化率" },
    "deviation": { "type": "number", "actualType": "string", "desc": "价格偏离度(%)" },
    "marketCap": { "type": "number", "actualType": "string", "desc": "市值(USD)" },
    "marketCapRanking": { "type": "integer", "actualType": "integer", "desc": "市值排名" },
    "circulatingSupply": { "type": "number", "actualType": "string", "desc": "流通供应量" },
    "circulationRate": { "type": "number", "actualType": "string", "desc": "流通率(%)" },
    "active": { "type": "integer", "actualType": "string", "desc": "24h活跃地址数" },
    "newly": { "type": "integer", "actualType": "string", "desc": "24h新增地址数" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货 2:合约 3:交割合约）" },
    "chanceCoinTradeDataV1Vos": {
      "type": "array",
      "desc": "交易时间数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围标识（如m15, H4）" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "时间粒度枚举值" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额(USD)" },
        "tradeAmount": { "type": "number", "actualType": "string", "desc": "交易总金额(USD)" }
      }
    },
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间（毫秒时间戳）" },
    "pushPrice": { "type": "number", "actualType": "string", "desc": "入场推送价格(USD)" },
    "pushMaxPrice": { "type": "number", "actualType": "string", "desc": "推送后最高价(USD)" },
    "gains": { "type": "number", "actualType": "number", "desc": "推送后涨幅(%)" },
    "pushMinPrice": { "type": "number", "actualType": "string", "desc": "推送后最低价(USD)" },
    "declines": { "type": "number", "actualType": "number", "desc": "推送后跌幅(%)" },
    "score": { "type": "number", "actualType": "number", "desc": "AI综合评分" },
    "scoreChange": { "type": "number", "actualType": "number", "desc": "评分变化" },
    "grade": { "type": "integer", "actualType": "integer", "desc": "机会等级(1-3, 3为最高)" },
    "alpha": { "type": "boolean", "actualType": "boolean", "desc": "是否Alpha信号" },
    "fomo": { "type": "boolean", "actualType": "boolean", "desc": "是否FOMO状态" },
    "fomoEscalation": { "type": "boolean", "actualType": "boolean", "desc": "是否FOMO加剧" },
    "bullishRatio": { "type": "number", "actualType": "number", "desc": "看涨情绪比例" },
    "bearishRatio": { "type": "number", "actualType": "number", "desc": "看跌情绪比例" }
  },
  "field_meta": {
    "cost": { "meaning": "主力成本价格", "range": "根据大额交易加权计算的主力持仓成本", "advice": "当前价格低于成本价时可能是买入机会" },
    "deviation": { "meaning": "价格偏离度", "range": "(当前价格 - 主力成本) / 主力成本 * 100%", "advice": "负值表示低于成本，正值表示高于成本" },
    "score": { "meaning": "AI综合评分", "range": "0-100，基于资金流、技术指标等综合计算", "advice": "评分<=45或>=80：待观察代币；45<评分<55：观察代币；55<评分<80：机会代币" },
    "grade": { "meaning": "机会等级", "range": "1-3，3为最高等级", "advice": "等级越高表示风险越高" },
    "pushPrice": { "meaning": "入场推送价格", "range": "系统首次推送该机会代币时的价格", "advice": "用于计算入场后的涨跌幅" },
    "gains": { "meaning": "推送后涨幅", "range": "(pushMaxPrice - pushPrice) / pushPrice * 100%", "advice": "推送后的最大涨幅" },
    "declines": { "meaning": "推送后跌幅", "range": "(pushPrice - pushMinPrice) / pushPrice * 100%", "advice": "推送后的最大跌幅" },
    "alpha": { "meaning": "Alpha信号", "range": "布尔值，表示是否具有超额收益潜力", "advice": "true时关注度应更高" },
    "fomo": { "meaning": "FOMO信号", "range": "布尔值，表示市场情绪是否过热", "advice": "true时需警惕追高风险" },
    "fomoEscalation": { "meaning": "FOMO加剧", "range": "布尔值，FOMO状态进一步升级", "advice": "true时风险显著增加" },
    "active": { "meaning": "24h活跃地址数", "range": "过去24小时内有交易的链上地址数量", "advice": "反映市场参与热度" },
    "newly": { "meaning": "24h新增地址数", "range": "过去24小时内首次持有该代币的地址数量", "advice": "反映新资金流入" },
    "bullishRatio": { "meaning": "看涨情绪比例", "range": "0-1，基于社媒分析", "advice": "越接近1表示市场越看涨" },
    "bearishRatio": { "meaning": "看跌情绪比例", "range": "0-1，基于社媒分析", "advice": "越接近1表示市场越看跌" },
    "tradeInflow": { "meaning": "交易净流入", "range": "正值为资金流入，负值为资金流出", "advice": "持续正值表示主力在吸筹" }
  },
  "enums": {
    "tradeType": { "1": "现货", "2": "合约（永续）", "3": "交割合约" },
    "timeParticleEnum": { "5": "5分钟", "15": "15分钟", "30": "30分钟", "101": "1小时", "104": "4小时", "124": "24小时", "201": "1天", "207": "7天", "230": "30天" }
  },
  "example": {
    "req": {},
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "23335",
          "symbol": "THE",
          "price": "0.2792",
          "maxPrice": "4.1032",
          "minPrice": "0.0722",
          "percentChange1h": "0.33",
          "percentChange24h": "1.42",
          "percentChange7d": "4.49",
          "percentChange30d": "7.90",
          "percentChange60d": "25.65",
          "percentChange90d": "56.37",
          "cost": "0.2709",
          "costChange": "0.0625",
          "deviation": "-1.42",
          "marketCap": "36026970.95",
          "marketCapRanking": 312,
          "circulatingSupply": "128932942.42",
          "circulationRate": "39.54",
          "active": "347",
          "newly": "347",
          "tradeType": 1,
          "chanceCoinTradeDataV1Vos": [
            { "timeRange": "m15", "timeParticleEnum": 15, "tradeInflow": "460.63", "tradeAmount": "3213.51" },
            { "timeRange": "m30", "timeParticleEnum": 30, "tradeInflow": "-338.10", "tradeAmount": "4455.51" },
            { "timeRange": "H4", "timeParticleEnum": 104, "tradeInflow": "-5145.62", "tradeAmount": "37250.34" }
          ],
          "updateTime": 1773016500000,
          "pushPrice": "0.2621",
          "pushMaxPrice": "0.2806",
          "gains": 0.0,
          "pushMinPrice": "0.2587",
          "declines": 1.30,
          "score": 45.0,
          "scoreChange": 10.0,
          "grade": 2,
          "alpha": false,
          "fomo": false,
          "fomoEscalation": false,
          "bullishRatio": 1.0,
          "bearishRatio": 0.0
        }
      ]
    }
  }
}

FILE:references/ai/risk-coin-messages.json
{
  "name": "风险代币消息列表",
  "endpoint": "POST /ai/getRiskCoinMessageList",
  "description": "获取AI通过多数据维度，对当前行情下具有下跌风险趋势的代币的追踪消息数据",
  "credits_cost": 3,
  "needToken": true,
  "use_case": "适用于当前行情下，对有下跌行情风险的代币，进行AI实时追踪的消息查询，适用于了解出货预警、下跌风险、反弹等风险信号",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "riskMessageType": { "type": "integer", "actualType": "integer", "desc": "预测类型" },
    "scoring": { "type": "number", "actualType": "number", "desc": "得分" },
    "grade": { "type": "integer", "actualType": "integer", "desc": "等级" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" },
    "percentChange24h": { "type": "number", "actualType": "number", "desc": "24小时涨跌幅" },
    "riskDecline": { "type": "number", "actualType": "number", "desc": "风险跌幅" },
    "rebound": { "type": "number", "actualType": "number", "desc": "反弹" }
  },
  "field_meta": {
    "riskMessageType": { "meaning": "风险消息类型", "advice": "标识风险信号类型，如出货预警、下跌风险、反弹等" },
    "riskDecline": { "meaning": "风险跌幅", "advice": "推送后价格下跌幅度，用于验证风险预警准确性" },
    "rebound": { "meaning": "反弹幅度", "advice": "价格下跌后的反弹程度" }
  },
  "example": {
    "req": { "vsTokenId": 38178 },
    "res": {
      "code": 200,
      "data": [
        {
          "updateTime": 1771317300000,
          "vsTokenId": "38178",
          "symbol": "TRUTH",
          "name": "Swarm Network",
          "riskMessageType": 19,
          "scoring": "",
          "grade": "",
          "price": "0.0118",
          "percentChange24h": -2.32,
          "riskDecline": 26.38,
          "rebound": 6.61
        }
      ]
    }
  }
}

FILE:references/chain/hold-trend.json
{
  "name": "持仓趋势",
  "endpoint": "POST /chain/trade/token/holdTrend",
  "description": "获取指定地址在区块链上对某个代币的持仓成本数据，支持通过指定代币、指定链名、指定时间段查询持仓成本来判断变化趋势",
  "credits_cost": 1,
  "needToken": true,
  "needCoinKey": true,
  "needAddress": true,
  "use_case": "适用于追踪特定地址的持仓成本变化，适用于分析地址的建仓成本区间，适用于评估地址的持仓策略和成本管理",
  "update_frequency": "每日更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "coinKey": { "type": "string", "req": true, "desc": "代币的coinKey（链+合约地址），通过代币详情获取" },
    "address": { "type": "string", "req": true, "desc": "地址" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "截止时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "balance": { "type": "number", "actualType": "string", "desc": "余额" },
    "holding": { "type": "number", "actualType": "string", "desc": "持仓成本" },
    "holdingPrice": { "type": "number", "actualType": "string", "desc": "持仓价格" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" }
  },
  "example": {
    "req": { "vsTokenId": 1, "coinKey": "BTC_BTC", "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", "endTime": 1773479265534 },
    "res": {
      "code": 200,
      "data": [
        { "vsTokenId": "1", "symbol": "BTC", "name": "Bitcoin", "date": 1542038400000, "balance": "0", "holding": "0", "holdingPrice": "0", "price": "6359.49" }
      ]
    }
  }
}

FILE:references/chain/large-trade.json
{
  "name": "大额交易",
  "endpoint": "POST /chain/trade/large",
  "description": "获取指定代币在BTC系列，EVM系列，波场系列20+主流公链上的大额交易数据",
  "credits_cost": 2,
  "needToken": true,
  "use_case": "适用于对代币在链上的大额交易或异常交易流动监控追踪及分析，适用于鲸鱼地址和交易所之间的大额转账监控，适用于追踪大户动向和市场异动预警",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "page": { "type": "integer", "req": false, "desc": "当前页，默认1" },
    "pageSize": { "type": "integer", "req": false, "desc": "当前页数据数量，默认10，最大100" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币 ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "blockNumber": { "type": "long", "actualType": "long", "desc": "区块高度" },
    "transIndex": { "type": "integer", "actualType": "integer", "desc": "交易在区块列表中的下标" },
    "coinKey": { "type": "string", "actualType": "string", "desc": "币标识" },
    "transHash": { "type": "string", "actualType": "string", "desc": "交易 hash" },
    "fromAddress": { "type": "string", "actualType": "string", "desc": "发出方地址" },
    "fromExchangeName": { "type": "string", "actualType": "string", "desc": "发出方标签" },
    "toAddress": { "type": "string", "actualType": "string", "desc": "接收方地址" },
    "toExchangeName": { "type": "string", "actualType": "string", "desc": "接收方标签" },
    "amount": { "type": "number", "actualType": "string", "desc": "交易金额" },
    "blockTime": { "type": "long", "actualType": "long", "desc": "区块时间（毫秒时间戳）" },
    "coinInfo": {
      "type": "object",
      "actualType": "object",
      "desc": "代币信息",
      "item": {
        "coinKey": { "type": "string", "actualType": "string", "desc": "币标识" },
        "coinName": { "type": "string", "actualType": "string", "desc": "币名" },
        "symbol": { "type": "string", "actualType": "string", "desc": "币标识" },
        "protocol": { "type": "string", "actualType": "string", "desc": "协议" },
        "contractAddress": { "type": "string", "actualType": "string", "desc": "合约地址" },
        "chainName": { "type": "string", "actualType": "string", "desc": "链名" },
        "icon": { "type": "string", "actualType": "string", "desc": "图标 URL" },
        "price": { "type": "number", "actualType": "string", "desc": "价格" }
      }
    },
    "addressInfo": {
      "type": "object",
      "actualType": "object",
      "desc": "地址信息",
      "item": {
        "address": { "type": "string", "actualType": "string", "desc": "地址" },
        "label": { "type": "object", "actualType": "object", "desc": "标签" },
        "balance": { "type": "number", "actualType": "string", "desc": "余额" },
        "profit": { "type": "number", "actualType": "string", "desc": "收益" }
      }
    },
    "exchangeInfo": {
      "type": "object",
      "actualType": "object",
      "desc": "交易所信息",
      "item": {
        "address": { "type": "string", "actualType": "string", "desc": "地址" },
        "name": { "type": "string", "actualType": "string", "desc": "名称" },
        "icon": { "type": "string", "actualType": "string", "desc": "图标" },
        "label": { "type": "object", "actualType": "object", "desc": "标签" },
        "addresses": { "type": "array", "actualType": "array", "desc": "地址列表" },
        "amount": { "type": "number", "actualType": "string", "desc": "金额" },
        "exchangeCount": { "type": "integer", "actualType": "integer", "desc": "交易所计数" }
      }
    }
  },
  "example": {
    "req": { "vsTokenId": 1, "page": 1, "pageSize": 10 },
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "1",
          "symbol": "BTC",
          "name": "Bitcoin",
          "blockNumber": 928673,
          "transIndex": 2779,
          "coinKey": "BTC_BTC",
          "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36",
          "fromAddress": "",
          "fromExchangeName": "",
          "toAddress": "",
          "toExchangeName": "Gate.io",
          "amount": "237.26",
          "blockTime": 1766216779000
        }
      ]
    }
  }
}

FILE:references/chain/holders.json
{
  "name": "持币地址",
  "endpoint": "POST /chain/trade/token/holdPage",
  "description": "获取指定代币在链上的持仓地址列表及地址的基础信息数据，同时支持指定地址的基础信息查询",
  "credits_cost": 2,
  "needToken": true,
  "needCoinKey": true,
  "use_case": "适用于鲸鱼、项目方、交易所等在链上的相关信息追踪与分析，适用于识别大户持仓行为和地址归属分析，适用于链上持仓分布和筹码集中度研究",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "page": { "type": "integer", "req": true, "desc": "当前页，默认1" },
    "pageSize": { "type": "integer", "req": true, "desc": "当前页数据数量，默认10，最多查询10000条数据" },
    "coinKey": { "type": "string", "req": true, "desc": "代币的coinkey信息（链+合约地址信息），通过代币详情获取" },
    "address": { "type": "string", "req": false, "desc": "地址" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "coinKey": { "type": "string", "actualType": "string", "desc": "代币键" },
    "address": { "type": "string", "actualType": "string", "desc": "地址" },
    "label": {
      "type": "object",
      "actualType": "object",
      "desc": "地址标签",
      "item": {
        "labelName": { "type": "string", "actualType": "string", "desc": "标签名" },
        "iconUrl": { "type": "string", "actualType": "string", "desc": "图标 URL" },
        "isContract": { "type": "boolean", "actualType": "boolean", "desc": "是否是合约地址" },
        "exchangeSymbol": { "type": "string", "actualType": "string", "desc": "交易所名称" },
        "labelType": { "type": "string", "actualType": "string", "desc": "类型" },
        "reliability": { "type": "integer", "actualType": "integer", "desc": "可信度" }
      }
    },
    "balance": { "type": "number", "actualType": "string", "desc": "余额" },
    "price": { "type": "number", "actualType": "string", "desc": "价格" },
    "profit": { "type": "number", "actualType": "string", "desc": "盈利" },
    "cost": { "type": "number", "actualType": "string", "desc": "持仓成本" },
    "preCost": { "type": "number", "actualType": "string", "desc": "前一次持仓成本" },
    "chainName": { "type": "string", "actualType": "string", "desc": "链名" }
  },
  "example": {
    "req": { "vsTokenId": 1, "page": 1, "pageSize": 10, "coinKey": "BTC_BTC" },
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "1",
          "symbol": "BTC",
          "name": "Bitcoin",
          "coinKey": "BTC_BTC",
          "address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
          "label": {
            "labelName": "Binance Cold Wallet",
            "iconUrl": "/icon/label/Binance.png",
            "isContract": false,
            "exchangeSymbol": "",
            "labelType": "Exchange",
            "reliability": ""
          },
          "balance": "248597.58",
          "price": "70624.86",
          "profit": "7913271920.43",
          "cost": "38828.44",
          "preCost": "38828.44",
          "chainName": "BTC"
        }
      ]
    }
  }
}

FILE:references/chain/trade-count-trend.json
{
  "name": "交易数量趋势",
  "endpoint": "POST /chain/trade/token/tradeCountTrend",
  "description": "获取指定地址在区块链上对某个代币的交易统计数据，支持通过指定代币、指定链名、指定时间段查询链上交易情况",
  "credits_cost": 1,
  "needToken": true,
  "needCoinKey": true,
  "needAddress": true,
  "use_case": "适用于追踪特定地址的交易活跃度，适用于分析地址的买卖行为和交易频率",
  "update_frequency": "每日更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "coinKey": { "type": "string", "req": true, "desc": "代币的coinKey（链+合约地址），通过代币详情获取" },
    "address": { "type": "string", "req": true, "desc": "地址" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "截止时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "fromCount": { "type": "number", "actualType": "string", "desc": "转出次数" },
    "toCount": { "type": "number", "actualType": "string", "desc": "转入次数" },
    "fromAmount": { "type": "number", "actualType": "string", "desc": "转出金额" },
    "toAmount": { "type": "number", "actualType": "string", "desc": "转入金额" },
    "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额 (USD)" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" }
  },
  "example": {
    "req": { "vsTokenId": 1, "coinKey": "BTC_BTC", "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", "endTime": 1773479265534 },
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "1",
          "symbol": "BTC",
          "name": "Bitcoin",
          "date": 1542038400000,
          "fromCount": "1",
          "toCount": "1",
          "fromAmount": "0.01",
          "toAmount": "0.01",
          "price": "6359.49"
        }
      ]
    }
  }
}

FILE:references/chain/profit-loss-trend.json
{
  "name": "盈亏趋势",
  "endpoint": "POST /chain/trade/token/profitLossTrend",
  "description": "获取指定地址在区块链上对某个代币的盈利或亏损的统计数据，支持通过指定代币、指定链名、指定时间段查询该地址的盈利或亏损数据",
  "credits_cost": 1,
  "needToken": true,
  "needCoinKey": true,
  "needAddress": true,
  "use_case": "适用于追踪特定地址的盈亏状况，适用于评估地址的投资绩效，适用于大户盈亏分析和市场情绪判断",
  "update_frequency": "每日更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "coinKey": { "type": "string", "req": true, "desc": "代币的coinKey（链+合约地址），通过代币详情获取" },
    "address": { "type": "string", "req": true, "desc": "地址" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "截止时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "total": { "type": "number", "actualType": "string", "desc": "累计盈亏" },
    "day": { "type": "number", "actualType": "string", "desc": "每日盈亏" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" }
  },
  "example": {
    "req": { "vsTokenId": 1, "coinKey": "BTC_BTC", "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", "endTime": 1773479265534 },
    "res": {
      "code": 200,
      "data": [
        { "vsTokenId": "1", "symbol": "BTC", "name": "Bitcoin", "date": 1542038400000, "total": "0", "day": "0", "price": "6359.49" }
      ]
    }
  }
}

FILE:references/chain/balance-trend.json
{
  "name": "余额趋势",
  "endpoint": "POST /chain/trade/token/balanceTrend",
  "description": "获取指定地址在区块链上对某个代币的持仓余额数据，支持通过指定代币、指定链名、指定时间段查询该地址的持仓余额来判断变化趋势",
  "credits_cost": 1,
  "needToken": true,
  "needCoinKey": true,
  "needAddress": true,
  "use_case": "适用于追踪特定地址的持仓余额变化，适用于判断地址的筹码积累和减持行为，适用于大户地址持仓动态监控",
  "update_frequency": "每日更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "coinKey": { "type": "string", "req": true, "desc": "代币的coinKey（链+合约地址），通过代币详情获取" },
    "address": { "type": "string", "req": true, "desc": "地址" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "截止时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "balance": { "type": "number", "actualType": "string", "desc": "余额" },
    "price": { "type": "number", "actualType": "string", "desc": "币价" }
  },
  "example": {
    "req": { "vsTokenId": 1, "coinKey": "BTC_BTC", "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", "endTime": 1773479265534 },
    "res": {
      "code": 200,
      "data": [
        {
          "vsTokenId": "1",
          "symbol": "BTC",
          "name": "Bitcoin",
          "date": 1542038400000,
          "balance": "0",
          "price": "6359.49"
        }
      ]
    }
  }
}

FILE:references/category/category-list.json
{
  "name": "板块资金列表",
  "endpoint": "POST /trade/categories/getTradeList",
  "description": "提供所有板块类别在不同时间窗口下的实时资金积累数据",
  "credits_cost": 3,
  "needToken": false,
  "use_case": "适用于板块轮动的资金积累数据监控，适用于发现热门板块或资金异动板块，适用于行业/板块级别的资金流向分析",
  "update_frequency": "实时更新",
  "params": {
    "tradeType": { "type": "integer", "req": true, "desc": "交易类型（1:现货，2:合约）" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间（毫秒时间戳）" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货，2:合约）" },
    "tag": { "type": "string", "actualType": "string", "desc": "板块名称" },
    "tagsSimplified": { "type": "string", "actualType": "string", "desc": "板块名称(中文)" },
    "categoriesTradeDataList": {
      "type": "array",
      "desc": "板块资金数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "统计时间粒度" },
        "tradeInflow": { "type": "number", "actualType": "number", "desc": "交易净流入金额 (USD)" }
      }
    }
  },
  "field_meta": {
    "tag": { "meaning": "板块英文标识", "advice": "用于后续查询板块下代币列表的参数" },
    "tagsSimplified": { "meaning": "板块中文名称", "advice": "用于展示给用户选择" },
    "categoriesTradeDataList": { "meaning": "板块资金数据", "advice": "该板块在不同时间粒度的资金净流入数据" }
  },
  "enums": {
    "tradeType": { "1": "现货", "2": "合约" }
  },
  "example": {
    "req": { "tradeType": 1 },
    "res": {
      "code": 200,
      "data": [
        { "updateTime": 1773298200000, "tradeType": 1, "tag": "Metaverse", "tagsSimplified": "元宇宙", "categoriesTradeDataList": [{ "timeRange": "m5", "timeParticleEnum": 5, "tradeInflow": -167 }] },
        { "updateTime": 1773298200000, "tradeType": 1, "tag": "Payments", "tagsSimplified": "Payments", "categoriesTradeDataList": [{ "timeRange": "m5", "timeParticleEnum": 5, "tradeInflow": 34939 }] }
      ]
    }
  }
}

FILE:references/category/category-tokens.json
{
  "name": "板块代币资金",
  "endpoint": "POST /trade/categories/CoinTradeList",
  "description": "获取指定板块下，所有代币的现货或合约在不同时间窗口下的实时资金积累数据",
  "credits_cost": 3,
  "needToken": true,
  "needTag": true,
  "use_case": "适用于板块轮动监控中，对板块下的代币的资金情况监控，适用于发现板块内的龙头代币或异动代币，适用于行业主题投资策略的资金分析",
  "params": {
    "tag": { "type": "string", "req": true, "desc": "分类标签（如AI, Metaverse）" },
    "tradeType": { "type": "integer", "req": true, "desc": "交易类型（1:现货，2:合约）" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "更新时间" },
    "tag": { "type": "string", "actualType": "string", "desc": "板块标签" },
    "tradeType": { "type": "integer", "actualType": "integer", "desc": "交易类型（1:现货，2:合约）" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "categoriesTradeDataList": {
      "type": "array",
      "desc": "资金数据列表",
      "item": {
        "timeRange": { "type": "string", "actualType": "string", "desc": "时间范围" },
        "timeParticleEnum": { "type": "integer", "actualType": "integer", "desc": "时间范围枚举值" },
        "tradeInflow": { "type": "number", "actualType": "string", "desc": "交易净流入金额" }
      }
    }
  },
  "enums": {
    "tradeType": { "1": "现货", "2": "合约" }
  },
  "example": {
    "req": { "tag": "AI", "tradeType": 1 },
    "res": {
      "code": 200,
      "data": [
        { "updateTime": 1773298200000, "tag": "AI", "tradeType": 1, "vsTokenId": "1637", "symbol": "RLC", "name": "iExec RLC", "categoriesTradeDataList": [{ "timeRange": "H6", "timeParticleEnum": 106, "tradeInflow": "3753.64" }] },
        { "updateTime": 1773298200000, "tag": "AI", "tradeType": 1, "vsTokenId": "1732", "symbol": "NMR", "name": "Numeraire", "categoriesTradeDataList": [{ "timeRange": "H6", "timeParticleEnum": 106, "tradeInflow": "-1088.40" }] }
      ]
    }
  }
}

FILE:references/indicator/sentiment.json
{
  "name": "社媒情绪",
  "endpoint": "POST /social-sentiment/getCoinSocialSentiment",
  "description": "提供单个代币的市场情绪指标数据，包括看涨、看跌、中立的观点比例和观点内容",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于对代币的市场情绪综合分析，适用于结合资金流向分析市场情绪与价格走势的关系，适用于判断市场多空情绪倾向",
  "notes": "自然语言输入市场情绪时可调用此接口，并同时调用实时资金数据接口来提供分析",
  "update_frequency": "定时更新（基于社交媒体数据采集）",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" }
  },
  "response": {
    "updateTime": { "type": "long", "actualType": "long", "desc": "数据更新时间" },
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "bullishRatio": { "type": "number", "actualType": "number", "desc": "看涨情绪比例" },
    "neutralRatio": { "type": "number", "actualType": "number", "desc": "中性情绪比例" },
    "bearishRatio": { "type": "number", "actualType": "number", "desc": "看跌情绪比例" },
    "bearishContents": {
      "type": "array",
      "desc": "看跌内容列表",
      "item": {
        "english": { "type": "string", "actualType": "string", "desc": "英文内容" },
        "updateTime": { "type": "long", "actualType": "long", "desc": "内容更新时间" }
      }
    },
    "neutralContents": {
      "type": "array",
      "desc": "中性内容列表",
      "item": {
        "english": { "type": "string", "actualType": "string", "desc": "英文内容" },
        "updateTime": { "type": "long", "actualType": "long", "desc": "内容更新时间" }
      }
    },
    "bullishContents": {
      "type": "array",
      "desc": "看涨内容列表",
      "item": {
        "english": { "type": "string", "actualType": "string", "desc": "英文内容" },
        "updateTime": { "type": "long", "actualType": "long", "desc": "内容更新时间" }
      }
    }
  },
  "example": {
    "req": { "vsTokenId": 1 },
    "res": {
      "code": 200,
      "data": {
        "updateTime": 1773315931000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "bullishRatio": 0.41,
        "neutralRatio": 0.49,
        "bearishRatio": 0.10,
        "bearishContents": [{ "english": "$BTC faces conflicting narratives...", "updateTime": 1773316047000 }],
        "neutralContents": [{ "english": "Whales and institutional actors...", "updateTime": 1773316047000 }],
        "bullishContents": [{ "english": "$BTC shows strong bullish conviction...", "updateTime": 1773316047000 }]
      }
    }
  }
}

FILE:references/indicator/dense-area.json
{
  "name": "压力支撑位",
  "endpoint": "POST /indicator/getDenseAreaList",
  "description": "获取AI通过多数据维度，动态生成代币的智能压力位与支撑位的价格数据",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于对代币关键价格位置获取，适用于辅助判断压力和支撑位，适用于支撑交易决策判断",
  "params": {
    "vsTokenId": { "type": "long", "req": false, "desc": "代币ID" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": false, "desc": "结束时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "name": { "type": "string", "actualType": "string", "desc": "代币名称" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "price": { "type": "number", "actualType": "string", "desc": "关键位价格" }
  },
  "example": {
    "req": { "vsTokenId": 1, "startTime": 1770825600000, "endTime": 1773417600000 },
    "res": {
      "code": 200,
      "data": [
        { "vsTokenId": "1", "symbol": "BTC", "name": "Bitcoin", "date": 1771059600000, "price": "69733.39" }
      ]
    }
  }
}

FILE:references/indicator/price-market.json
{
  "name": "主力行为指标",
  "endpoint": "POST /indicator/getPriceMarketList",
  "description": "获取BTC或ETH在特定时间范围内的，因主力动作可能影响到价格趋势的特色指标数据",
  "credits_cost": 1,
  "needToken": true,
  "use_case": "适用于对BTC和ETH的价格大趋势判断参考，适用于识别主力行为对价格的影响和整体价格趋势走向判断",
  "update_frequency": "实时更新",
  "params": {
    "vsTokenId": { "type": "long", "req": true, "desc": "代币ID" },
    "startTime": { "type": "long", "req": false, "desc": "开始时间（毫秒时间戳）" },
    "endTime": { "type": "long", "req": true, "desc": "结束时间（毫秒时间戳）" }
  },
  "response": {
    "vsTokenId": { "type": "long", "actualType": "string", "desc": "代币ID" },
    "symbol": { "type": "string", "actualType": "string", "desc": "代币符号" },
    "date": { "type": "long", "actualType": "long", "desc": "时间（毫秒时间戳）" },
    "priceMarketType": { "type": "integer", "actualType": "integer", "desc": "价格趋势（1：上涨，2：下跌）" }
  },
  "enums": {
    "priceMarketType": {
      "1": "上涨",
      "2": "下跌"
    }
  },
  "example": {
    "req": { "vsTokenId": 1, "startTime": 1770825600000, "endTime": 1773417600000 },
    "res": {
      "code": 200,
      "data": [
        { "vsTokenId": "1", "symbol": "BTC", "date": 1773158400000, "priceMarketType": 1 }
      ]
    }
  }
}