快速入门

接入流程

第一步：获取 API 密钥

在「控制台」，获取您的 API-KEY`。

第二步：选择环境

环境	基础 URL	用途
预发布环境	https://api-beta.valuescan.io/api	开发测试
正式环境	https://api.valuescan.io/api	生产环境

第三步：发起第一个请求

以「代币列表」接口为例：

请求示例

{
    "search": "BTC"
}

cURL 示例

curl --location --request POST 'https://api.valuescan.io/api/open/v1/vs-token/list' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: 您的API密钥' \
--header 'X-TIMESTAMP: 毫秒时间戳' \
--header 'X-SIGN: 签名' \
--data-raw '{
    "search": "BTC"
}'

第四步：处理响应

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "symbol": "BTC",
            "name": "Bitcoin"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}

核心参数说明

参数	说明	获取方式
vsTokenId	代币唯一标识	通过「代币列表」接口获取
coinKey	链上代币标识	通过「代币信息」接口获取

典型调用链路

1. 代币列表 → 获取 vsTokenId
      ↓
2. 代币信息 → 获取代币详情及 coinKey
      ↓
3. 业务接口 → 调用具体数据接口（K线、资金、链上等）

下一步

• 阅读「基础信息」了解完整接口规范
• 阅读「错误处理」了解错误码定义
• 查阅具体接口文档获取详细参数说明