docs: update coins field structure in news.ai_update

- Add individual AI ratings (score/signal/grade) for each coin in coins array
- Remove deprecated fields (status/summary/enSummary) from aiRating
- Clarify that top-level aiRating.score represents the highest score among all coins
- Update documentation across all languages (EN/ZH/JA/KO)
This commit is contained in:
tkk
2026-05-06 16:08:06 +08:00
parent 4e8266b305
commit f20d81ce4e
4 changed files with 155 additions and 44 deletions
+38 -8
View File
@@ -375,20 +375,39 @@ For news with AI analysis (if subscribed):
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [...],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"score": 85,
"signal": "long",
"grade": "A"
},
{
"symbol": "ETH",
"market_type": "spot",
"score": 45,
"signal": "short",
"grade": "B"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "Chinese summary",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
}
```
**Note**: Each coin in the `coins` array now includes individual AI ratings:
- `score`: 0-100 impact score for this specific coin
- `signal`: `long` / `short` / `neutral` for this coin
- `grade`: `A+` / `A` / `B+` / `B` / `C` for this coin
The top-level `aiRating.score` represents the highest score among all coins.
---
## Data Structure
@@ -402,7 +421,16 @@ Each article returns:
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [{ "symbol": "BTC", "market_type": "spot", "match": "title" }],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"match": "title",
"score": 85,
"signal": "long",
"grade": "A"
}
],
"aiRating": {
"score": 85,
"grade": "A",
@@ -417,9 +445,11 @@ Each article returns:
| AI Field | Description |
|----------|-------------|
| `score` | 0-100 impact score |
| `score` | 0-100 impact score (top-level = highest among all coins) |
| `signal` | `long` (bullish) / `short` (bearish) / `neutral` |
| `status` | `done` = AI analysis completed |
| `coins[].score` | Individual coin impact score (0-100) |
| `coins[].signal` | Individual coin signal (long/short/neutral) |
| `coins[].grade` | Individual coin grade (A+/A/B+/B/C) |
---
+39 -12
View File
@@ -375,20 +375,39 @@ AI 分析付きニュース(購読している場合):
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [...],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"score": 85,
"signal": "long",
"grade": "A"
},
{
"symbol": "ETH",
"market_type": "spot",
"score": 45,
"signal": "short",
"grade": "B"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "中国語の要約",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
}
```
**注意**`coins` 配列内の各コインには個別の AI 評価が含まれます:
- `score`:このコインの影響スコア(0-100)
- `signal`:このコインのシグナル方向(long/short/neutral
- `grade`:このコインのグレード(A+/A/B+/B/C
トップレベルの `aiRating.score` は全コイン中の最高スコアを表します。
---
## データ構造
@@ -402,14 +421,20 @@ AI 分析付きニュース(購読している場合):
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [{ "symbol": "BTC", "market_type": "spot", "match": "title" }],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"match": "title",
"score": 85,
"signal": "long",
"grade": "A"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "中国語の要約",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
@@ -417,9 +442,11 @@ AI 分析付きニュース(購読している場合):
| AI フィールド | 説明 |
|-------------|------|
| `score` | 0-100 影響度スコア |
| `score` | 0-100 影響度スコア(トップレベル = 全コイン中の最高スコア) |
| `signal` | `long`(強気)/ `short`(弱気)/ `neutral` |
| `status` | `done` = AI 分析完了 |
| `coins[].score` | 個別コインの影響度スコア(0-100) |
| `coins[].signal` | 個別コインのシグナル方向(long/short/neutral |
| `coins[].grade` | 個別コインのグレード(A+/A/B+/B/C |
---
+39 -12
View File
@@ -375,20 +375,39 @@ AI 분석이 있는 뉴스 (구독한 경우):
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [...],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"score": 85,
"signal": "long",
"grade": "A"
},
{
"symbol": "ETH",
"market_type": "spot",
"score": 45,
"signal": "short",
"grade": "B"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "중국어 요약",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
}
```
**참고**: `coins` 배열의 각 코인에는 개별 AI 평가가 포함됩니다:
- `score`: 해당 코인의 영향력 점수 (0-100)
- `signal`: 해당 코인의 시그널 방향 (long/short/neutral)
- `grade`: 해당 코인의 등급 (A+/A/B+/B/C)
최상위 `aiRating.score`는 모든 코인 중 최고 점수를 나타냅니다.
---
## 데이터 구조
@@ -402,14 +421,20 @@ AI 분석이 있는 뉴스 (구독한 경우):
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [{ "symbol": "BTC", "market_type": "spot", "match": "title" }],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"match": "title",
"score": 85,
"signal": "long",
"grade": "A"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "중국어 요약",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
@@ -417,9 +442,11 @@ AI 분석이 있는 뉴스 (구독한 경우):
| AI 필드 | 설명 |
|---------|------|
| `score` | 0-100 영향도 점수 |
| `score` | 0-100 영향도 점수 (최상위 = 모든 코인 중 최고 점수) |
| `signal` | `long`(강세) / `short`(약세) / `neutral` |
| `status` | `done` = AI 분석 완료 |
| `coins[].score` | 개별 코인의 영향도 점수 (0-100) |
| `coins[].signal` | 개별 코인의 시그널 방향 (long/short/neutral) |
| `coins[].grade` | 개별 코인의 등급 (A+/A/B+/B/C) |
---
+39 -12
View File
@@ -375,20 +375,39 @@ $env:OPENNEWS_TOKEN = "<your-token>"
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [...],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"score": 85,
"signal": "long",
"grade": "A"
},
{
"symbol": "ETH",
"market_type": "spot",
"score": 45,
"signal": "short",
"grade": "B"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "中文摘要",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
}
```
**注意**`coins` 数组中的每个币种现在包含独立的 AI 评分:
- `score`:该币种的影响力评分(0-100
- `signal`:该币种的信号方向(long/short/neutral
- `grade`:该币种的评级(A+/A/B+/B/C
顶层 `aiRating.score` 代表所有币种中的最高分。
---
## 数据结构
@@ -402,14 +421,20 @@ $env:OPENNEWS_TOKEN = "<your-token>"
"newsType": "Bloomberg",
"engineType": "news",
"link": "https://...",
"coins": [{ "symbol": "BTC", "market_type": "spot", "match": "title" }],
"coins": [
{
"symbol": "BTC",
"market_type": "spot",
"match": "title",
"score": 85,
"signal": "long",
"grade": "A"
}
],
"aiRating": {
"score": 85,
"grade": "A",
"signal": "long",
"status": "done",
"summary": "中文摘要",
"enSummary": "English summary"
"signal": "long"
},
"ts": 1708473600000
}
@@ -417,9 +442,11 @@ $env:OPENNEWS_TOKEN = "<your-token>"
| AI 字段 | 描述 |
|---------|------|
| `score` | 0-100 影响力评分 |
| `score` | 0-100 影响力评分(顶层 = 所有币种中的最高分) |
| `signal` | `long`(看涨)/ `short`(看跌)/ `neutral`(中性) |
| `status` | `done` = AI 分析完成 |
| `coins[].score` | 单个币种的影响力评分(0-100) |
| `coins[].signal` | 单个币种的信号方向(long/short/neutral |
| `coins[].grade` | 单个币种的评级(A+/A/B+/B/C |
---