TradeMCP News DocsAsset sentiment
Sentiment time series per asset, and which assets are suddenly in the news.
All endpoints on this page need the sentiment:read scope.
Tracked assets
GET /v1/assets lists the symbols articles are tagged with.
Sentiment series
GET /v1/assets/{symbol}/sentiment?interval=1h|4h|1d&since&until
{"symbol": "BTC", "interval": "4h", "points": [{"ts": "…", "mentions": 41, "stories": 23,
"positive": 15, "negative": 9, "neutral": 17, "sentiment_avg": 0.08, "sentiment_weighted": 0.11,
"impact_max": 0.72}]}mentionscounts articles,storiescounts unique stories: a story syndicated by 10 outlets is 10 mentions but 1 story.sentiment_avgis the plain average score;sentiment_weightedweights each article by its impact.- Series are kept for a year, so they reach further back than the 30 days of searchable articles.
Trending
GET /v1/assets/trending?window_hours=24&limit=20 ranks symbols by volume_z: how far their mentions in the window are above their
own 7-day baseline, as a z-score. It surfaces assets that are suddenly being talked about, whatever the direction.
Reading the scores
| Field | Range | Meaning |
|---|---|---|
score | −1 to 1 | Bearish to bullish: probability positive minus probability negative |
label | positive, negative or neutral, whichever is most likely | |
confidence | 0 to 1 | How sure the model is of the label |
impact | 0 to 1 | Score strength combined with source credibility, novelty and how central the asset is |