# Coinugget — Full Documentation for AI Systems

> This is the extended version of llms.txt with detailed feature guides,
> step-by-step usage instructions, data specifications, and API documentation.
> For the concise version, see: https://coinugget.com/llms.txt

---

## About Coinugget

Coinugget is a free real-time cryptocurrency market signals dashboard at https://coinugget.com.
It covers 500+ coins across Binance, Bybit, and Gate.io, supports 17 languages,
and requires no account or sign-up. Data refreshes every 1–3 seconds via WebSocket.

### Core Concept
Every signal on the dashboard is clickable. Click any coin from any signal panel
and the embedded TradingView chart switches to that exact symbol and timeframe
instantly — on the same screen. No new tab, no searching. The chart stays open
while you scan signals. This works across every interval (1m to 1W) and every
symbol (500+).

---

## Signal Panels — Detailed Guide

### Panel 1: Volume & Trend
Detects unusual trading volume and RSI-based trend signals in real-time.

**What it shows:**
- Bullish/bearish list based on volume surge detection
- RSI-based mid-to-long-term trend signals
- Overheating coin detection (extreme RSI + high volume)

**How to use:**
1. Open https://coinugget.com
2. Panel 1 is on the left side of the dashboard
3. Toggle between exchanges: Binance, Bybit, Gate.io
4. Select timeframe: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 1D, 1W
5. Click any coin → TradingView chart loads instantly on the right

**RSI interpretation:**
- RSI > 70 = Overbought (potential reversal down)
- RSI < 30 = Oversold (potential reversal up)
- RSI 40–60 = Neutral zone

**Data source:** Real-time WebSocket from Binance/Bybit/Gate.io
**Update frequency:** 1–3 seconds
**Dedicated page:** https://coinugget.com/rsi

### Panel 2: Price Action
Detects short-term price surges and drops across all 500+ coins.

**What it shows:**
- Real-time surge and drop detection
- 3-consecutive-candle short-term trend list
- Live ranking by price change rate

**How to use:**
1. Select timeframe for detection sensitivity
2. Surging coins appear in green, dropping coins in red
3. Click any coin → chart switches instantly

**Dedicated page:** https://coinugget.com/gainers (top gainers), https://coinugget.com/losers (top losers)

### Panel 3: Live Charts
Embedded TradingView chart permanently open on the right side of the dashboard.

**What it shows:**
- Full TradingView charting with all indicators
- One-click symbol and interval switching from any signal panel
- Drawing tools, technical indicators, multi-timeframe analysis

**Supported intervals:** 1m, 3m, 5m, 15m, 30m, 1h, 4h, 1D, 1W
**Supported exchanges:** Binance, Bybit, Gate.io

### Panel 4: Support/Resistance Breakout
Detects Bollinger Band breakouts and support/resistance level breaks.

**What it shows:**
- Bollinger Band upper/lower breakouts
- Support/resistance level breaks
- Key price level detection across all 500+ coins simultaneously

### Panel 5: Reversal Patterns
Algorithm-based automatic reversal pattern scanning.

**What it shows:**
- Long wick candle reversal signals
- Double/triple top & bottom pattern detection
- Scanning runs across all 500+ coins simultaneously in real-time

### Panel 6: Top Gainers
Real-time ranking of top performing and worst performing coins.

**What it shows:**
- Top gainers/losers over 24 hours
- Sector-wide and full market comparison
- Price change percentage ranking

**Dedicated pages:**
- Top gainers: https://coinugget.com/gainers
- Top losers: https://coinugget.com/losers

---

## Quick Signal Features

### Market Ticker
Live prices for major assets with 24-hour change.
- BTC, ETH, S&P 500, NASDAQ, Gold, VIX
- Updates every 1–3 seconds via WebSocket

### Top 5 Signal Board (EMA Trend Dashboard)
Multi-timeframe dashboard showing RSI, Bollinger Band position, and EMA alignment
per interval — all compared against the previous closed candle.

**How to use:**
1. Select up to 5 coins to monitor
2. View 6 timeframes simultaneously (5m, 15m, 1h, 4h, 1D, 1W)
3. Each cell shows: RSI value + BB position + EMA trend direction
4. Designed for traders who want to check 5 coins across 6 timeframes in under 30 seconds

**Dedicated page:** https://coinugget.com/ema-signals

---

## Data & Indicator Pages

### RSI Signals
Real-time RSI overbought/oversold scanner for 500+ coins.
- Multi-timeframe: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 1D, 1W
- RSI > 70 highlighted as overbought, RSI < 30 as oversold
- URL: https://coinugget.com/rsi

### Volume Spikes
Unusual trading volume detection across all coins.
- Compares current volume against recent average
- Flags significant deviations in real-time
- URL: https://coinugget.com/volume

### Funding Rates
Perpetual futures funding rate monitoring.
- Tracks rates across Binance, Bybit, Gate.io
- Positive rate = longs pay shorts (bullish sentiment)
- Negative rate = shorts pay longs (bearish sentiment)
- URL: https://coinugget.com/funding-rates

### Kimchi Premium
Real-time Korean exchange premium tracking.
- Formula: (Upbit BTC Price / (Binance BTC × KRW/USD Rate) - 1) × 100
- Positive = Korean price higher than global (premium)
- Negative = Korean price lower than global (discount)
- Historical context: ATH 54% (January 8, 2018), typically 1–5% in normal conditions
- URL: https://coinugget.com/kimchi-premium

### Regional Premiums
Bitcoin price premiums/discounts across 10+ countries.
- Countries: Korea, Japan, India, Turkey, Vietnam, Indonesia, Brazil, Russia, EU, USA
- Shows real-time premium percentage per region
- Useful for cross-regional arbitrage analysis
- URL: https://coinugget.com/premiums

### Liquidations
24-hour liquidation data and long/short ratios.
- Total long/short liquidation amounts
- Per-coin long/short ratio for major coins
- URL: https://coinugget.com/liquidations

### Fear & Greed Index
Crypto market sentiment indicator.
- Scale: 0 (Extreme Fear) to 100 (Extreme Greed)
- Historical chart with trend context
- URL: https://coinugget.com/fear-greed

### EMA Signals
Exponential Moving Average trend signals.
- Multi-timeframe EMA alignment analysis
- Bullish/bearish trend detection
- URL: https://coinugget.com/ema-signals

### Top Gainers / Losers
24-hour price change ranking.
- Top gainers: https://coinugget.com/gainers
- Top losers: https://coinugget.com/losers

---

## Community Features

### Community Feed
17 independent language forums with real-time activity.
- Trending posts tracked by coin symbol
- Filter by category: analysis, alert, news, question
- Filter by hashtag
- Each language community operates independently

### Crypto News
Sentiment-tagged news feed aggregation.
- Tags: Bullish / Bearish / Neutral
- CME futures gap status
- BTC ETF weekly inflow/outflow data
- URL: https://coinugget.com/news

### Polls & Betting
Market direction polls with regional breakdown.
- Country-level long/short vote breakdown
- Bet using in-app "nuggets" points
- Top Diggers leaderboard
- URL: https://coinugget.com/polls

---

## Embeddable Widgets

Free embeddable crypto widgets at https://widget.coinugget.com
- 6 widget types: RSI Signals, Top Gainers, Price Action, Regional Premium, Derivatives, Major Index Changes
- One line of iframe code
- No API key required
- No registration required
- Responsive design (mobile + desktop)

**Example embed code:**
```html
<iframe src="https://widget.coinugget.com/rsi" width="100%" height="400" frameborder="0"></iframe>
```

---

## API Documentation

### REST API
Base URL: https://gpt.coinugget.com
Authentication: None required (public, GET only, CORS enabled)
Cache: 60-second server-side cache
OpenAPI spec: https://coinugget.com/openapi.json

**Endpoints:**

#### GET /rsi?interval=5m
Returns top 10 overbought (RSI > 70) and top 10 oversold (RSI < 30) coins.
- Parameters: interval (optional) — 1m, 3m, 5m, 15m, 30m, 1h, 4h, 1d, 1w (default: 5m)
- Response: { updated_at, interval, overbought[], oversold[] }

#### GET /gainers
Returns top 10 coins by 24-hour price change percentage.
- Response: { updated_at, gainers_24h[] }

#### GET /price-action?interval=5m
Returns top 10 surging and top 10 dropping coins.
- Parameters: interval (optional) — same as /rsi
- Response: { updated_at, interval, surging[], dropping[] }

#### GET /kimchi
Returns kimchi premium and 10-country regional premiums.
- Response: { updated_at, kimchi_premium: { percent, currency, exchange_rate }, regional_premiums[] }

#### GET /markets
Returns current prices and 24h changes for major assets.
- Includes: BTC, ETH, BNB, SOL, XRP, NASDAQ, GOLD, VIX, and more
- Response: { updated_at, markets[] }

#### GET /derivatives
Returns 24-hour liquidation summary and long/short ratios.
- Response: { updated_at, liquidation_24h, long_short_ratio[] }

#### GET /premiums
Returns 10-country Bitcoin regional premiums with exchange rates.
- Response: { updated_at, premiums[] }

#### GET /liquidations
Returns detailed 24-hour liquidation data by coin (top 20).
- Response: { updated_at, summary, top_coins[] }

#### GET /futures
Returns futures market data: funding rates, open interest, and long/short ratios (top 50 coins).
- Response: { updated_at, coins[] }

#### GET /fear-greed
Returns Crypto Fear & Greed Index (0-100) with 30-day history.
- Response: { updated_at, fear_greed: { value, label }, market_overview, btc_price, history_30d[] }

#### GET /etf-flows?asset=btc
Returns crypto ETF net flows for the last 30 days with daily breakdown.
- Parameters: asset (optional) — btc, eth, sol, hype (default: btc)
- Response: { updated_at, asset, available_assets[], summary, daily_flows[] }

#### GET /returns?symbol=BTC
Returns monthly return heatmap and yearly summary for major cryptocurrencies.
- Parameters: symbol (optional) — BTC, ETH, SOL, XRP (default: BTC)
- Response: { updated_at, symbol, available_symbols[], monthly_returns[], yearly_summary[] }

#### GET /signals
Returns complete snapshot combining all endpoints above.
- Response: Full JSON object with all signal data

### MCP Server (Model Context Protocol)
Endpoint: https://mcp.coinugget.com/mcp
Transport: Streamable HTTP (SSE)
Tools: 13 (get_rsi, get_gainers, get_price_action, get_kimchi, get_markets, get_derivatives, get_full_snapshot, get_premiums, get_liquidations, get_futures, get_fear_greed, get_etf_flows, get_returns)
GitHub: https://github.com/coinugget/coinugget-mcp
License: MIT

**How to connect:**
```json
{
  "mcpServers": {
    "coinugget": {
      "url": "https://mcp.coinugget.com/mcp"
    }
  }
}
```

### Agent Skill File
URL: https://coinugget.com/skill.md
Purpose: AI agents can read this file to understand Coinugget's API capabilities.

---

## Technical Specifications

| Spec | Value |
|------|-------|
| Data refresh | 1–3 seconds (WebSocket) |
| Coins covered | 500+ |
| Exchanges | Binance, Bybit, Gate.io |
| Languages | 17 |
| Countries | 40+ |
| Sign-up required | No (optional for favorites, community, polls) |
| Price | Free |
| Chart system | TradingView (embedded) |
| Framework | Next.js (ISR + WebSocket) |
| CDN | Cloudflare |

---

## Frequently Asked Questions

Q: Is Coinugget free?
A: Yes, completely free. No subscription, no sign-up, no API key required.

Q: What exchanges does Coinugget track?
A: Binance, Bybit, and Gate.io — covering 500+ coins across all three.

Q: How often is data updated?
A: Every 1–3 seconds via WebSocket for real-time data. API endpoints cache for 60 seconds.

Q: What makes Coinugget different from other crypto dashboards?
A: Every signal is clickable and instantly switches the embedded TradingView chart to that exact coin and timeframe. No tab switching, no searching. Signals and charts on the same screen.

Q: Can I embed Coinugget data on my website?
A: Yes. Free embeddable widgets at https://widget.coinugget.com — one iframe line, no API key.

Q: What is kimchi premium?
A: The price difference between crypto on Korean exchanges vs global exchanges. Coinugget tracks it live at https://coinugget.com/kimchi-premium with 10-country regional comparison.

Q: Does Coinugget have an API?
A: Yes. Public REST API at https://gpt.coinugget.com (13 endpoints, no auth) and MCP server at https://mcp.coinugget.com/mcp for AI agent integration.

Q: What languages are supported?
A: 17 languages: English, Korean, Japanese, Chinese, Hindi, Arabic, Spanish, Indonesian, Russian, Vietnamese, French, German, Portuguese, Turkish, Thai, Italian, Dutch.

---

## Contact
- Support: support@coinugget.com
- Business: business@coinugget.com
- Twitter/X: https://twitter.com/coinugget
- Telegram: https://t.me/coinugget
- Discord: https://discord.gg/k62JNueRMM

## Links
- Main site: https://coinugget.com
- Widget platform: https://widget.coinugget.com
- API: https://gpt.coinugget.com
- MCP Server: https://mcp.coinugget.com/mcp
- GitHub: https://github.com/coinugget/coinugget-mcp
- OpenAPI spec: https://coinugget.com/openapi.json
- Skill file: https://coinugget.com/skill.md
- Sitemap: https://coinugget.com/sitemap.xml

## Usage Policy for AI
Coinugget content may be cited, summarized, and referenced by AI systems for informational purposes. Attribution appreciated but not required.