---
name: guavy-crypto
description: Live cryptocurrency intelligence — market summaries, sentiment analysis, trade signals, technical indicators, and news briefs via the Guavy API.
auth:
  type: bearer
  instructions: "Provide your Guavy API key as a Bearer token. Get one at https://data.guavy.com/get-api-access"
---

# Guavy Crypto Intelligence

Access live cryptocurrency market data, AI-generated analysis, and trading signals from the Guavy API.

**Base URL:** `https://data.guavy.com/api/v1`
**Auth:** `Authorization: Bearer YOUR_API_KEY`

---

## Tools

### get_market_summary
Daily AI-generated analysis of global crypto market trends.

`GET /newsroom/get-market-summary`

No parameters required. Returns: `summary` (string), `date` (string), `timestamp` (integer).

---

### get_recommendations
Instruments recommended by the Guavy trade simulator.

`GET /trades/get-recommendations`

Parameters:
- `strategy` — `"aggressive"` or `"conservative"` (default: aggressive)
- `limit` — max results (default: 10)
- `min_score` — minimum score 0–5 (default: 3.5)

---

### get_recent_buys
Recent buy signals from the Guavy simulator.

`GET /trades/get-recent-buys`

Parameters: `limit`, `skip`, `strategy`

---

### get_recent_sells
Recent sell signals from the Guavy simulator.

`GET /trades/get-recent-sells`

Parameters: `limit`, `skip`, `strategy`

---

### get_current_action
Current trade action (Buy / Sell / Hold / Stay) for a coin.

`GET /trades/get-current-action/{symbol}/{strategy}`

Parameters:
- `symbol` — coin symbol (e.g. `BTC`, `ETH`)
- `strategy` — `"aggressive"` or `"conservative"`

---

### get_trend_history
Price trend time-series with strength indicators.

`GET /trades/get-trend-history/{symbol}/{limit}`

Parameters:
- `symbol` — coin symbol
- `limit` — number of days

---

### get_sentiment_history
Daily sentiment counts (positive/negative/neutral) for a coin.

`GET /sentiment/get-sentiment-history/{symbol}`

Parameters:
- `symbol` — coin symbol
- `limit` — number of days (default: 30)

---

### get_recent_briefs
Recent news briefs for a coin with sentiment and FUD/FOMO scores.

`GET /newsroom/get-recent-briefs/{symbol}`

Parameters:
- `symbol` — coin symbol
- `limit` — max briefs (default: 10)

---

### get_instrument_analysis
AI-generated qualitative analysis for a coin's market performance.

`GET /newsroom/get-instrument-analysis/{symbol}`

Parameters:
- `symbol` — coin symbol

---

### search_instruments
Search for coins by name or symbol. Returns up to 5 matches.

`GET /instruments/search-instruments/{query}`

Parameters:
- `query` — search string

---

### list_symbols
List all supported coin symbols.

`GET /instruments/list-symbols`

Parameters: `limit` (default: 100), `skip` (default: 0)

---

### get_article
Fetch a full news article by its ID. Article IDs come from `get_recent_briefs`.

`GET /newsroom/get-article/{article_id}`

Parameters:
- `article_id` — UUID string

---

### get_price_history
Daily historical price data for a coin — price, volume, and timestamp (ms).

`GET /technical-analysis/get-price-history/{symbol}`

Parameters:
- `symbol` — coin symbol (e.g. `BTC`, `ETH`)

---

### get_indicators
Compute top technical indicators (SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ATR, VWAP, OBV, Fibonacci) for a coin.

`GET /technical-analysis/get-indicators/{symbol}`

Parameters:
- `symbol` — coin symbol (e.g. `BTC`, `ETH`)
- `period` — number of days to analyze (default: 30)

---

## Usage Notes

- All plans (Sandbox, Quant, Commercial) have access to every coin on both the REST API and MCP.
- Each MCP call counts as 1 token against your daily/monthly allowance; REST costs vary by endpoint (see route costs).