Guavy Logo GUAVY
Newsroom Get Recent Briefs
GET
·
/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": "22ef7b03-f4dd-49b5-903f-bc632942ecae",
      "body": "BlackRock has launched the iShares Staked Ethereum Trust ETF (ETHB) on the Nasdaq, offering investor...",
      "clout": 85.0,
      "date": "2026-03-14",
      "fud_fomo_bias": "fomo",
      "fud_fomo_score": 1,
      "impacted_coins": [
        {
          "asset": "ETH",
          "confidence": 9,
          "direction": "bullish",
          "timeframe": "short"
        },
        {
          "asset": "ETC",
          "confidence": 6,
          "direction": "neutral",
          "timeframe": "long"
        },
        {
          "asset": "GLD",
          "confidence": 8,
          "direction": "bullish",
          "timeframe": "short"
        }
      ],
      "sentiment": 4,
      "speculation_score": 4,
      "symbols": [
        "BTC",
        "ETH",
        "coinbase"
      ],
      "timestamp": 1773457211902,
      "title": "BlackRock Enters Staking-enabled Ethereum Market with iShare...",
      "tone": "neutral"
    },
    {
      "article_id": "cbe05085-269b-4953-9ddb-bafdfa757242",
      "body": "Despite the ongoing US-Iran conflict and its effects on global markets, Bitcoin has remained relativ...",
      "clout": 30.0,
      "date": "2026-03-14",
      "fud_fomo_bias": "fomo",
      "fud_fomo_score": 5,
      "impacted_coins": [
        {
          "asset": "BTC",
          "confidence": 9,
          "direction": "bullish",
          "timeframe": "short"
        },
        {
          "asset": "S&P 500 (equities)",
          "confidence": 8,
          "direction": "bearish",
          "timeframe": "short"
        },
        {
          "asset": "Gold",
          "confidence": 7,
          "direction": "neutral",
          "timeframe": "short"
        }
      ],
      "sentiment": 2,
      "speculation_score": 8,
      "symbols": [
        "BTC",
        "crypto"
      ],
      "timestamp": 1773457060978,
      "title": "Bitcoin Holds Steady Amidst Global Market Volatility",
      "tone": "neutral"
    }
  ]
}

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

API Limits

The Guavy API has a limit of 10 simultaneous connections. You'll receive a 429 error if you reach the limit. At exceptionally high volumes, you may receive an HTTP 429 or 403 without a JSON body.

We recommend that you cache frequently accessed values that do not change often in your application's data store. This will prevent your application from bumping up against the throttling limitations and will likely provide faster access to that data.

Account Limits

Your Guavy account will typically have a licensed limit of at least 100,000 API calls per month. In addition, there is a limit of 10,000 API calls per day. If you reach these limits, you will receive a 429 error.

Connection Timeouts

The Guavy API has a 120-second timeout on API calls. You may see this type of timeout after you've made a network socket connection and are already sending and receiving data. Response times are dependent on the complexity of your request and the general load across Guavy. Some endpoints in the Guavy API return values that are large and slow to calculate.

Was this helpful?
Feedback option #{picture.id}
Feedback option #{picture.id}
Feedback option #{picture.id}
Feedback option #{picture.id}

© 2026 Guavy Inc. All rights reserved.