·
/api/v2/commodities/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://guavy.com/api/v2/commodities/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/v2/commodities/newsroom/get-recent-briefs/Oil?limit=2
{
"briefs": [
{
"article_id": "07dcd3dc-2214-4550-a490-5b428798761d",
"body": "Gold prices remain steady around $4,000 an ounce as traders await clues on inflation from the Middle...",
"clout": 82.0,
"date": "2026-07-21",
"fud_fomo_bias": "fud",
"fud_fomo_score": 3,
"impacted_coins": [
{
"asset": "BTC",
"confidence": 7,
"direction": "bearish",
"timeframe": "long"
},
{
"asset": "ETH",
"confidence": 6,
"direction": "bearish",
"timeframe": "long"
}
],
"sentiment": 1.3,
"speculation_score": 4,
"symbols": [
"Oil",
"Gold"
],
"timestamp": 1784597834094,
"title": "Gold Holds Steady Amid Middle East Conflict Uncertainty",
"tone": "formal"
},
{
"article_id": "3709527f-8f92-4c47-b5ea-8e65685aa788",
"body": "The Saudi-led coalition in Yemen has pledged to protect ships from the Houthis after they threatened...",
"clout": 100.0,
"date": "2026-07-21",
"fud_fomo_bias": "fud",
"fud_fomo_score": 2,
"impacted_coins": [
{
"asset": "oil futures (e.g. CL=F)",
"confidence": 9,
"direction": "bearish",
"timeframe": "short"
},
{
"asset": "Saudi Aramco (ARAMCO)",
"confidence": 8,
"direction": "neutral",
"timeframe": "long"
},
{
"asset": "IRGC-linked companies or assets",
"confidence": 7,
"direction": "bearish",
"timeframe": "short"
}
],
"sentiment": -2,
"speculation_score": 4,
"symbols": [
"Oil"
],
"timestamp": 1784597182120,
"title": "Houthis Threaten Maritime Blockade as Saudi-Led Coalition St...",
"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 instruments mentioned in the article.
Each entry includes the following keys:
asset
string
Ticker symbol of the referenced instrument (e.g., Oil, Gold).
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/v2/commodities/instruments/list-symbols | 1 |
| GET /api/v2/commodities/newsroom/get-recent-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v2/commodities/newsroom/search-briefs/:symbol | 3 – 8 (scales with limit) |
| GET /api/v2/commodities/newsroom/get-article/:id | 3 |
| GET /api/v2/commodities/sentiment/get-sentiment-history/:symbol | 3 – 12 (scales with limit) |
| GET /api/v2/commodities/technical-analysis/get-price-history/:symbol | 5 |
| GET /api/v2/commodities/technical-analysis/get-indicators/:symbol | 8 |
Account Limits
Each plan includes a monthly token budget: 3,000 for Sandbox, 250,000 for Quant, and 1,000,000 for Pro. Your monthly plan budget resets to the full amount on the 1st of each month — unused base tokens don't carry over. You can top up at any time with a one-time token pack; pack tokens never expire and any unused pack balance rolls forward. If you exceed your budget, the API returns a 401 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?
Next