Newsroom
Get Recent Briefs
·
/api/v1/newsroom/get-recent-briefs
Get Recent Briefs
Fetch news briefs for a specific instrument using its symbol.
Attributes
symbol
string
Required
The symbol to fetch news for.
limit
integer
The maximum number of news briefs to return. Defaults to 100.
API Request
Example Request with cURL
curl \
--request GET \
--url 'https://data.guavy.com/api/v1/newsroom/get-recent-briefs/<symbol>?limit=<integer>' \
--header 'Authorization: Bearer YOUR-GUAVY-ACCESS-TOKEN' \
--header 'Content-Type: application/json'
This request format works across all modern HTTP clients, including Python requests, JavaScript fetch, and other programming language libraries.
Example Response for /api/v1/newsroom/get-recent-briefs/btc?limit=2
{
"briefs": [
{
"article_id": "aaa224a5-65dc-41ea-a4ad-96d5289f2130",
"body": "Binance has expanded its Card program in collaboration with Mastercard, allowing users to make every...",
"clout": 82.0,
"date": "2026-04-28",
"fud_fomo_bias": "fomo",
"fud_fomo_score": 2,
"impacted_coins": [
{
"asset": "BNB",
"confidence": 8,
"direction": "bullish",
"timeframe": "short"
},
{
"asset": "USDT",
"confidence": 6,
"direction": "neutral",
"timeframe": "short"
},
{
"asset": "BTC",
"confidence": 7,
"direction": "bullish",
"timeframe": "short"
}
],
"sentiment": 3,
"speculation_score": 4,
"symbols": [
"BNB",
"ADA",
"BTC",
"USDT",
"crypto",
"XRP",
"ETH",
"FDUSD",
"USDC",
"LINK"
],
"timestamp": 1777350459771,
"title": "Binance Expands Card Program for Seamless Crypto Transaction...",
"tone": "neutral"
},
{
"article_id": "85709016-9dc0-4567-bf1d-553cecead2a6",
"body": "The price of Ether (ETH) has fallen to $2,287 after being rejected at the $2,400 level for the fourt...",
"clout": 75.0,
"date": "2026-04-28",
"fud_fomo_bias": "fud",
"fud_fomo_score": 6,
"impacted_coins": [
{
"asset": "ETH",
"confidence": 8,
"direction": "bearish",
"timeframe": "short"
}
],
"sentiment": -3.4,
"speculation_score": 4,
"symbols": [
"BTC",
"crypto",
"ETH"
],
"timestamp": 1777350447651,
"title": "Ether price struggles with triple top formation and supply a...",
"tone": "formal"
}
]
}
Response Object
briefs
array[object]
The array of news brief objects, with the following keys:
article_id
string
The unique identifier of the associated article.
body
string
The text body of the brief. This may contain HTML tags.
clout
integer
A score, between 0 and 100, of the publisher's audience, credibility, and trust.
date
string
Date of publication.
fud_fomo_score
integer
Intensity of emotional bias in the article's language. Scores range from 0 (neutral/factual) to 10 (pure manipulation with almost no factual content).
fud_fomo_bias
string
Direction of emotional bias: 'neutral' (balanced/factual), 'fud' (fear, uncertainty, doubt), or 'fomo' (fear of missing out, hype).
impacted_coins
array[object]
Directional price outlooks for coins mentioned in the article.
Each entry includes the following keys:
asset
string
Ticker symbol of the referenced coin (e.g., BTC, ETH).
confidence
integer
Confidence score from 0 (low) to 10 (high).
direction
string
Predicted direction: bullish, bearish, or neutral.
timeframe
string
Duration of the outlook, either short, long, or short to long.
sentiment
integer
A sentiment score for the article between -5 (very negative) and +5 (very positive).
speculation_score
integer
Quantifies how much an article relies on opinion, prediction, or unverified claims versus confirmed, factual reporting.
Scores range from 0 (entirely factual, verified information) to 10 (pure speculation with no factual grounding).
symbols
array[string]
The list of symbols mentioned in the article.
timestamp
integer
UNIX timestamp (in milliseconds) of publication.
title
string
The title of the brief.
tone
string
The tone of the brief
Token Costs
Each API call consumes tokens from your monthly budget. Endpoints that return richer or deeper data cost more tokens. Historical endpoints scale with the amount of data requested.
| Endpoint | Token Cost |
|---|---|
| GET /api/v1/ping | 1 |
| GET /api/v1/instruments/list-symbols | 1 |
| GET /api/v1/instruments/search-instruments/:query | 2 |
| GET /api/v1/instruments/get-detail/:symbol | 5 |
| GET /api/v1/instruments/scorecard/:symbol | 10 |
| GET /api/v1/newsroom/get-market-summary | 3 |
| GET /api/v1/newsroom/get-article/:id | 3 |
| GET /api/v1/newsroom/get-recent-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v1/newsroom/search-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v1/newsroom/get-instrument-analysis/:symbol | 10 |
| GET /api/v1/trades/get-recent-buys | 3 |
| GET /api/v1/trades/get-recent-sells | 3 |
| GET /api/v1/trades/get-recommendations | 5 |
| GET /api/v1/trades/get-current-action/:symbol/:strategy | 5 |
| GET /api/v1/trades/get-trend-history/:symbol/:limit | 5 – 15 (scales with limit) |
| GET /api/v1/trades/get-backtest-history/:symbol/:strategy | 8 – 20 (scales with years) |
| GET /api/v1/trades/get-backtest-summary/:symbol/:strategy | 8 – 20 (scales with years) |
| GET /api/v1/sentiment/get-sentiment-history/:symbol | 3 – 12 (scales with limit) |
| GET /api/v1/technical-analysis/get-price-history/:symbol | 5 |
| GET /api/v1/technical-analysis/get-indicators/:symbol | 8 |
Account Limits
Each plan includes a monthly token budget: 3,000 for Sandbox, 250,000 for Quant, and 2,000,000 for Commercial. You can top up at any time with a one-time token pack — unused tokens roll over every month. If you exceed your budget, the API returns a 403 until the next reset or until you purchase more tokens.
Connection Limits
The Guavy API has a limit of 10 simultaneous connections and a 120-second timeout per request. We recommend caching responses that don't change frequently to reduce token consumption and improve performance.
Was this
helpful?
Prev
Next