Search Briefs

Search news brief titles for matching keywords for a specific coin. Results are restricted to the past 24 hours.

Attributes

symbol

string

Required

Coin symbol to search briefs for (e.g. BTC, ETH).

keywords

string

Search keywords to match against brief titles (case-insensitive). Defaults to empty string (all briefs).

limit

integer

The maximum number of briefs to return. Defaults to 20.

API Request

Example Request with cURL

curl \
--request GET \
--url     'https://guavy.com/api/v2/crypto/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/v2/crypto/newsroom/search-briefs/BTC?keywords=bitcoin+legislation&limit=5`

{
  "briefs": [
    {
      "article_id": "54d42483-f02c-4920-915c-63005814e4c2",
      "body": "Cathie Wood has made another bullish prediction for Bitcoin, forecasting a bright future for the cry...",
      "clout": 60.0,
      "date": "2026-06-30",
      "fud_fomo_bias": "fomo",
      "fud_fomo_score": 3,
      "impacted_coins": [
        {
          "asset": "BTC",
          "confidence": 8,
          "direction": "bullish",
          "timeframe": "short"
        }
      ],
      "sentiment": 3,
      "speculation_score": 4,
      "symbols": [
        "BTC",
        "crypto"
      ],
      "timestamp": 1782850663419,
      "title": "Wood Doubles Down on Bitcoin Optimism",
      "tone": "neutral"
    },
    {
      "article_id": "3b602241-82ee-484e-aad0-dbd32d0c6221",
      "body": "Bitcoin's price fell to $65,000 due to ongoing geopolitical tensions in the Middle East, which are k...",
      "clout": 70.0,
      "date": "2026-06-30",
      "fud_fomo_bias": "fud",
      "fud_fomo_score": 5,
      "impacted_coins": [
        {
          "asset": "BTC",
          "confidence": 9,
          "direction": "bearish",
          "timeframe": "short"
        }
      ],
      "sentiment": -3,
      "speculation_score": 4,
      "symbols": [
        "BTC",
        "crypto"
      ],
      "timestamp": 1782850425407,
      "title": "Bitcoin Slumps to $65K Amid Escalating Middle East Tensions",
      "tone": "formal"
    }
  ]
}

Response Object

briefs

array[object]

The array of matching news brief objects. Same structure as get-recent-briefs.

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/crypto/instruments/list-symbols	1
GET /api/v2/crypto/newsroom/get-recent-briefs/:symbol	3 – 8 (scales with limit)
GET /api/v2/crypto/newsroom/search-briefs/:symbol	3 – 8 (scales with limit)
GET /api/v2/crypto/newsroom/get-article/:id	3
GET /api/v2/crypto/sentiment/get-sentiment-history/:symbol	3 – 12 (scales with limit)
GET /api/v2/crypto/technical-analysis/get-price-history/:symbol	5
GET /api/v2/crypto/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?

Get Recent Briefs

Get Article