Search Briefs
Attributes
API Request
Example Request with cURL
curl \
--request GET \
--url 'https://data.guavy.com/api/v1/newsroom/search-briefs/<symbol>?keywords=<string>&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/search-briefs/BTC?keywords=bitcoin+legislation&limit=5
{
"briefs": [
{
"article_id": "ef6439f5-ac1e-4123-9466-40f566c1d327",
"body": "Morgan Stanley increased its Bitcoin holdings by 266.56 BTC through its spot Bitcoin ETF MSBT, bring...",
"clout": 40.0,
"date": "2026-06-20",
"fud_fomo_bias": "neutral",
"fud_fomo_score": 1,
"impacted_coins": [
{
"asset": "BTC",
"confidence": 8,
"direction": "bullish",
"timeframe": "long"
}
],
"sentiment": 3,
"speculation_score": 4,
"symbols": [
"BTC",
"ARKM"
],
"timestamp": 1781921655855,
"title": "Morgan Stanley Bolsters Bitcoin Holdings with $17 Million In...",
"tone": "neutral"
},
{
"article_id": "52ff81d3-2698-4a34-bb85-b1c187b8f96f",
"body": "Bitcoin's price surged above $67,000 in response to a potential US-Iran deal, marking a multi-week p...",
"clout": 65.0,
"date": "2026-06-20",
"fud_fomo_bias": "fomo",
"fud_fomo_score": 4,
"impacted_coins": [
{
"asset": "BTC",
"confidence": 8,
"direction": "bullish",
"timeframe": "short"
},
{
"asset": "BTC",
"confidence": 6,
"direction": "bearish",
"timeframe": "short"
}
],
"sentiment": 2.5,
"speculation_score": 8,
"symbols": [
"BTC",
"crypto"
],
"timestamp": 1781921060617,
"title": "Geopolitics Spark Bitcoin Surge Above $67,000",
"tone": "neutral"
}
]
}
Response Object
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.
