{"name":"Coinugget Public Data API","version":"1.0","description":"Free, no-key crypto market data. Notably includes post-surge outcome tracking — what happens AFTER a coin surges, which no other public dataset provides.","base_url":"https://coinugget.com/api/public","auth":"none","rate_limit":{"requests":100,"window":"1 hour","scope":"per IP","header":"X-RateLimit-Remaining"},"license":"Free to use with attribution to Coinugget (https://coinugget.com)","attribution_example":"Data: Coinugget (https://coinugget.com/stats)","source":"https://coinugget.com/stats","endpoints":[{"path":"/stats/insights","method":"GET","cache":"15 minutes","description":"Post-surge outcome statistics grouped by surge magnitude. A surge is a coin gaining 10%+ in 24h; outcomes are tracked at 1h/4h/1d/3d/7d after detection.","returns":["surge_band","sample_size","avg_return_pct","still_up_after_7d_pct"],"example":"https://coinugget.com/api/public/stats/insights"},{"path":"/stats/snapshot","method":"GET","cache":"5 minutes","params":{"sections":"comma-separated subset of available_sections (optional)"},"description":"Signal win rates across 5 indicator types and 4 intervals, active coins, post-surge tracking rows, weekly activity heatmap, win-rate trend, and Korea premium.","returns":["outcome","active_coins","top10_perf","top10_summary","heatmap","wr_trend","kimchi"],"example":"https://coinugget.com/api/public/stats/snapshot?sections=wr_trend,kimchi"},{"path":"/market/snapshot","method":"GET","cache":"1 minute","params":{"exchange":"binance | bybit | gate | mexc (optional)"},"description":"Real-time top gainers, volume spikes and price action across four exchanges.","example":"https://coinugget.com/api/public/market/snapshot?exchange=binance"},{"path":"/market/onchain","method":"GET","cache":"5 minutes","description":"Fear & Greed index, regional premiums across 10 countries (including the Korea \"kimchi\" premium), market overview (dominance, altcoin season index, stablecoin cap), and CME gap.","returns":["fear_greed","regional_premiums","market_overview","cme_gap","btc_price"],"example":"https://coinugget.com/api/public/market/onchain"},{"path":"/market/etf-flows","method":"GET","cache":"1 hour","params":{"asset":"btc | eth | sol | hype (default btc)","days":"1-365 (default 30)"},"description":"Daily spot ETF net flows in USD millions, broken out per issuer plus Total. BTC history from 2024-01-11.","example":"https://coinugget.com/api/public/market/etf-flows?asset=btc&days=30"},{"path":"/cross-assets","method":"GET","cache":"1 minute","description":"Crypto (BTC, ETH, XRP, BNB, SOL) and traditional assets (NASDAQ, gold, WTI, DXY, KOSPI) captured at the same timestamp.","example":"https://coinugget.com/api/public/cross-assets"},{"path":"/market/derivatives","method":"GET","cache":"5 minutes","params":{"limit":"1-200 coins in the liquidation table (default 100)","sections":"liquidations | funding | open_interest | long_short (comma-separated, optional)"},"description":"24h liquidation totals and per-coin liquidations, funding rates with annualised equivalents, open interest and its 24h change, and long/short positioning.","returns":["liquidation_summary","liquidation_by_coin","funding_rates","open_interest","long_short_ratio"],"example":"https://coinugget.com/api/public/market/derivatives?sections=liquidations,funding&limit=20"},{"path":"/market/rsi","method":"GET","cache":"2 minutes","params":{"interval":"5m | 15m | 30m | 1h | 4h | 1d (optional)","limit":"1-30 (default 10)"},"description":"Overbought and oversold rankings by RSI, merged across Binance, Bybit and Gate.","example":"https://coinugget.com/api/public/market/rsi?interval=4h&limit=10"},{"path":"/market/volume","method":"GET","cache":"2 minutes","params":{"interval":"as above","limit":"1-30"},"description":"Volume spikes and collapses by timeframe. low_liquidity marks thin books.","example":"https://coinugget.com/api/public/market/volume?interval=1h"},{"path":"/market/movers","method":"GET","cache":"2 minutes","params":{"interval":"as above","limit":"1-30"},"description":"Biggest gainers and losers by timeframe, merged across exchanges.","example":"https://coinugget.com/api/public/market/movers?interval=1d"},{"path":"/returns","method":"GET","cache":"1 hour","params":{"symbol":"BTC | ETH | SOL | XRP (default BTC)","period":"weekly | monthly (default weekly)","from":"YYYY-MM-DD (default 2010-01-01)"},"description":"Period returns with win rate, best and worst periods, and percentiles. BTC weekly history reaches back to July 2010.","returns":["stats","series"],"example":"https://coinugget.com/api/public/returns?symbol=BTC&period=monthly&from=2017-01-01"},{"path":"/history/signals","method":"GET","cache":"30 minutes","params":{"kind":"rsi | pattern | price_action | bollinger | hybrid (default rsi)","interval":"5m | 15m | 30m | 1h | 4h | 1d (optional)","days":"1-730 (default 90)","by":"interval | direction | exchange | symbol (default interval)"},"description":"What actually happened after a signal fired. Average 1h/4h/1d/3d/7d change from the signal price and the share that finished positive, aggregated over 1.1M recorded signals. Buckets under 20 signals are omitted.","returns":["sample","buckets"],"example":"https://coinugget.com/api/public/history/signals?kind=pattern&by=direction&days=180"},{"path":"/history/top10","method":"GET","cache":"30 minutes","params":{"days":"1-400 (default 30)","rank":"1-10 — include individual traces for that board rank (optional)","detail":"1 — widen traces from 50 to 200 rows"},"description":"What happened to coins after they appeared on the 24h gainer board, grouped by board rank, with forward returns measured from the snapshot price.","returns":["by_rank","traces"],"example":"https://coinugget.com/api/public/history/top10?days=90&rank=1"}],"response_envelope":{"data":"endpoint-specific payload","dataset_version":"schema version","updated_at":"when the upstream data was produced (UTC)","generated_at":"when this response was built (UTC)","source":"canonical page for this dataset","docs":"https://coinugget.com/api/public/docs","license":"attribution terms"},"errors":{"405":"method_not_allowed","429":"rate_limit_exceeded — see Retry-After header","502":"upstream_unavailable"}}