社媒情绪
接口描述
提供单个代币的市场情绪指标数据，包括看涨、看跌、中立的观点比例和观点内容。
使用场景：
- 适用于对代币的市场情绪综合分析
- 适用于结合资金流向分析市场情绪与价格走势的关系
- 适用于判断市场多空情绪倾向
使用提示：
- 自然语言输入市场情绪时可调用此接口，并同时调用实时资金数据接口来提供分析
数据更新频率：每30分钟更新一次
请求URL
- 方法：
POST - 路径：
/open/v1/social-sentiment/getCoinSocialSentiment
积分消耗
- 消耗积分：
3
前置条件
获取 vsTokenId
| 条件 | 说明 | 获取方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用缓存的 vsTokenId，无需重复查询 | 上下文自动提取 |
| 未有 vsTokenId | 调用 POST /vs-token/list 接口获取 | 前置接口调用 |
请求参数
参数通过请求体（Body）以 JSON 格式传递。
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代币 ID |
响应字段
仅展示 data 对象内的字段结构：
| 字段 | 类型 | 实际返回类型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 数据更新时间（毫秒时间戳） |
| vsTokenId | long | string | 代币 ID |
| symbol | string | string | 代币符号 |
| name | string | string | 代币名称 |
| bullishRatio | number | number | 看涨情绪比例 (0-1) |
| neutralRatio | number | number | 中性情绪比例 (0-1) |
| bearishRatio | number | number | 看跌情绪比例 (0-1) |
| bearishContents | array | array | 看跌总结内容列表 |
| english | string | string | 英文内容 |
| updateTime | long | long | 内容更新时间（毫秒时间戳） |
| neutralContents | array | array | 中性总结内容列表 |
| english | string | string | 英文内容 |
| updateTime | long | long | 内容更新时间（毫秒时间戳） |
| bullishContents | array | array | 看涨总结内容列表 |
| english | string | string | 英文内容 |
| updateTime | long | long | 内容更新时间（毫秒时间戳） |
字段业务含义
以下字段需要特别说明其业务含义：
| 字段 | 业务含义 | 范围/计算方式 | 使用建议 |
|---|---|---|---|
| bullishRatio | 看涨情绪比例 | 0-1，基于社媒内容情感分析 | 越接近 1 表示市场越看涨 |
| neutralRatio | 中性情绪比例 | 0-1，基于社媒内容情感分析 | 表示市场观望情绪占比 |
| bearishRatio | 看跌情绪比例 | 0-1，基于社媒内容情感分析 | 越接近 1 表示市场越看跌 |
| bullishContents | 看涨内容摘要 | 社媒内容的 AI 总结 | 了解市场看涨的具体原因 |
| bearishContents | 看跌内容摘要 | 社媒内容的 AI 总结 | 了解市场看跌的具体原因 |
请求示例
json
{
"vsTokenId": 1 // 代币关键字 (vsTokenId)
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1773315931000, // 数据更新时间
"vsTokenId": "1", // 代币关键字 (vsTokenId)
"symbol": "BTC", // 代币符号
"name": "Bitcoin", // 代币名称
"bullishRatio": 0.4113, // 看涨情绪比例
"neutralRatio": 0.4937, // 中性情绪比例
"bearishRatio": 0.095, // 看跌情绪比例
"bearishContents": [
{
"english": "$BTC faces conflicting narratives...", // 英文内容
"updateTime": 1773316047000 // 内容更新时间
},
{
"english": "$BTC faces intense bearish pressure...",
"updateTime": 1773314274000
},
{
"english": "Whales and treasury entities...",
"updateTime": 1773312461000
}
// ... 更多数据省略
],
"neutralContents": [
{
"english": "Whales and institutional actors...",
"updateTime": 1773316047000
},
{
"english": "$BTC remains central to macro speculation...",
"updateTime": 1773312461000
},
{
"english": "$BTC faces immediate resistance at $70K...",
"updateTime": 1773310591000
}
// ... 更多数据省略
],
"bullishContents": [
{
"english": "$BTC shows strong bullish conviction...",
"updateTime": 1773316047000
},
{
"english": "Whales are driving momentum...",
"updateTime": 1773314274000
},
{
"english": "Whales are reactivating long-dormant...",
"updateTime": 1773312461000
}
// ... 更多数据省略
]
},
"requestId": "xxx-xxx-xxx"
}