·
/api/v1/newsroom/get-article
Get Article
Fetch a news article using its unique identifier (ID). IDs are returned in the 'Get Recent Briefs' route.
Attributes
article_id
string
Required
The unique identifier of the article to retrieve.
API Request
Example Request with cURL
curl \
--request GET \
--url 'https://guavy.com/api/v1/newsroom/get-article/<article_id>' \
--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-article/a11c5fcb-c3b8-4b6d-9454-ea6df6d85e4f
{
"article_id": "6b52cbb0-ec8f-42e0-982e-54d782444bb1",
"body": "XRP-focused ETFs have emerged as an exception in the turbulent crypto market. Despite recent downturns, institutional demand for XRP remains strong, according to data from SosoValue. On June 29, th...",
"clout": 78.0,
"date": "2026-06-30",
"fud_fomo_bias": "fomo",
"fud_fomo_score": 2,
"impacted_coins": [
{
"asset": "XRP",
"confidence": 8,
"direction": "bullish",
"timeframe": "short"
},
{
"asset": "BTC (influenced by institutional interest in XRP)",
"confidence": 6,
"direction": "neutral",
"timeframe": "long"
}
],
"sentiment": 2.3,
"speculation_score": 4,
"symbols": [
"BTC",
"crypto",
"XRP",
"ETH"
],
"timestamp": 1782846565143,
"title": "Bitwise Dominates XRP ETF Inflows as Institutional Demand Remains Strong",
"tone": "neutral"
}
Response Object
article_id
string
The unique identifier of the article.
body
string
The text body of the article. 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
A 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 article.
tone
string
The tone of the article.
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 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 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?
Next