# Swolecharts

> Free, no-login crypto derivatives data: live volume spikes, liquidations and liquidation heatmaps, funding rates, open interest, long/short ratios and Hyperliquid analytics across Binance, Bybit, Hyperliquid and other venues. Recorded from exchange public APIs; every page links its method.

Everything here is free to read and cite; link back to the page you used. Not financial advice.

## Key pages

- [All coins](https://swolecharts.com/coins)
- [Open interest](https://swolecharts.com/open-interest)
- [Long/short ratio](https://swolecharts.com/long-short-ratio)
- [Crypto liquidations](https://swolecharts.com/liquidations)
- [Funding rates](https://swolecharts.com/funding-rates)
- [Volume Monitor](https://swolecharts.com/)
- [Hyperliquid](https://swolecharts.com/hyperliquid)
- [All pages](https://swolecharts.com/tools): grouped index of every page

## Choose a source and answer scope

- Observed rolling liquidations: [Liquidations](https://swolecharts.com/liquidations), including rolling 24h totals across covered exchanges; Binance reports are sampled lower bounds. [Heatmaps](https://swolecharts.com/liquidation-heatmap) estimate liquidation levels, not executed liquidations; see [heatmap methodology](https://swolecharts.com/methodology/liquidation-heatmap).
- Cross-exchange funding: [Funding rates](https://swolecharts.com/funding-rates) uses 8h-equivalent quotes. [Hyperliquid funding](https://swolecharts.com/hyperliquid/funding-rate) shows actual hourly quotes. Quoted rates are not settled funding payments.
- Open interest: [Open interest](https://swolecharts.com/open-interest) totals trusted eligible markets; check [coverage](https://swolecharts.com/coverage) and [data accuracy](https://swolecharts.com/data-accuracy) for inclusion and limitations.
- Hyperliquid positions: [Whales](https://swolecharts.com/hyperliquid/whales) and [cohorts](https://swolecharts.com/hyperliquid/cohorts) cover tracked wallets only, not every trader or all exchange positions.

### Dated sources (URL templates, not live links)

- `https://swolecharts.com/liquidations/daily/{YYYY-MM-DD}`: observed liquidations for one UTC day, not rolling 24h. Choose an available date from [daily liquidations](https://swolecharts.com/liquidations/daily).
- `https://swolecharts.com/funding-rates/daily/{YYYY-MM-DD}`: UTC-day averages of observed 8h-equivalent funding quotes, not settled payments. Choose a date from [daily funding](https://swolecharts.com/funding-rates/daily).
- Daily pages distinguish current (partial), settling (late hourly data may arrive) and closed days; check coverage and state before citing. Closed does not promise an immutable snapshot.
- `https://swolecharts.com/coin-day/{BASE}/{YYYY-MM-DD}`: BASE is restricted to BTC, ETH, SOL; only today and the previous 29 UTC days (30-day admission window). Binance reference perpetual only, with hourly observations, quoted funding and sampled liquidations; not an all-exchange coin snapshot. Recomputed from retained data; current/settling days may be incomplete. Start at [coins](https://swolecharts.com/coins), open the supported coin's parent page (`/coin/{BASE}`) for its current recap, then use the recap's date navigation.

## URL patterns (templates, not live links)

- `https://swolecharts.com/coin/{BASE}`: one coin's price, open interest, funding and liquidations; BASE is e.g. BTC
- `https://swolecharts.com/coin/{BASE}/{METRIC}`: one metric's chart for a coin; METRIC is one of funding-rate, open-interest, liquidations, long-short-ratio, volume-spikes, volume
- `https://swolecharts.com/api/coin/{BASE}`: JSON for one coin
- `https://swolecharts.com/api/series/{METRIC}?base={BASE}&range=7d`: JSON history; METRIC is one of price, volume, oi, funding, liquidations, long-short, taker-flow, cvd, basis, spot-perp-volume, net-positioning, ob-depth, bid-ask-ratio (see /developers)

## JSON API (free, key optional)

Docs with parameters and sample responses: [https://swolecharts.com/developers](https://swolecharts.com/developers). Units:

Machine-readable contract: [OpenAPI 3.1 JSON](https://swolecharts.com/openapi.json).

- Defaults for common core market fields only; per-endpoint OpenAPI and /developers contracts take precedence.
- Core market timestamps default to epoch milliseconds, UTC; open interest, volume and liquidations to USD notional.
- Core funding rates and changes (oi_1h, px_24h) are plain fractions: 0.0001 means 0.01%.
- Core long/short fields are long share fractions (0.62 = 62% long), not a long/short quotient; check each contract.
- Exceptions: /api/contract-changes as_of, event time and delist_time are ISO 8601 UTC strings; /api/hyperliquid/cohorts/{COIN} range and range_s are integer seconds (t remains epoch ms).
- Percent exceptions: /api/kimchi-premium/history and /api/coinbase-premium/history use percent; Hyperliquid cohorts dim=ls accounts_long/value_long are 0-100 long shares, and whale liq_distance_pct is percent. Funding change_pp and OI acceleration_pp are percentage points, not fractions.

- `GET https://swolecharts.com/api/open-interest-acceleration`: Matched 1h OI acceleration, at most 50 contracts including unavailable rows.
- `GET https://swolecharts.com/api/funding-percentiles`: Own-history funding percentiles for the top 50 perps by OI.
- `GET https://swolecharts.com/api/coins/overlay`: 2–5 crypto coins' aggregate price or OI, rebased to 100.
- `GET https://swolecharts.com/api/series/{METRIC}`: History for one metric as compact time/value arrays.
- `GET https://swolecharts.com/api/markets`: Spot and perpetual markets.
- `GET https://swolecharts.com/api/coin/{BASE}`: One coin now: market row, recent spikes, long/short history and liquidations.
- `GET https://swolecharts.com/api/liquidations`: Rolling 1h/4h/12h/24h liquidation totals by venue and coin, plus the biggest and latest orders since the process started.
- `GET https://swolecharts.com/api/long-short`: Latest Binance and Bybit long/short account and top-trader ratios per coin.
- `GET https://swolecharts.com/api/order-book-depth`: Top 20 Binance/Bybit USDT perps by OI: bid/ask USD within ±0.1/0.5/1/2% of mid, imbalance and $1M market-order cost (bps). Derived figures only.
- `GET https://swolecharts.com/api/perp-dex-ranking`: Hyperliquid, Aster and Lighter by OI: 24h volume, shares, volume/OI and top 10 markets.
- `GET https://swolecharts.com/api/altcoin-season`: Share of top 50 altcoins beating BTC over 90 days: altcoin season index, history and coin returns vs BTC.
- `GET https://swolecharts.com/api/derivatives-fear-greed`: Daily Derivatives Fear & Greed index (0-100), up to a year, with component scores funding, oi (OI change), ls (long/short) and liq.
- `GET https://swolecharts.com/api/spike-stats`: Price 5, 15 and 60 minutes after volume spikes: hit rates, quartiles and means by exchange, level, direction and segment.
- `GET https://swolecharts.com/api/spike-stats/{COIN}`: The same for one coin, by exchange (HIP-3 separate) and direction, plus its last 20 volume spikes (recent).
- `GET https://swolecharts.com/api/new-listings`: Binance and Bybit USDT perps listed in the window, newest first, with change since listing (Binance), OI, volume and funding.
- `GET https://swolecharts.com/api/kimchi-premium/history`: Hourly Upbit and Bithumb premium vs Binance for one coin, in percent.
- `GET https://swolecharts.com/api/coinbase-premium/history`: Hourly Coinbase USD premium vs Binance spot for BTC or ETH: percent and USD gap.
- `GET https://swolecharts.com/api/heatmap-validation`: Liquidation heatmap 30-day accuracy: Spearman rho vs a baseline, hit rates, per-coin days.
- `GET https://swolecharts.com/api/options/{COIN}`: BTC/ETH options per expiry: max pain, OI and 24h volume (coins), put/call ratios, USD notional. Every 5 minutes.
- `GET https://swolecharts.com/api/options/{COIN}/iv`: IV per expiry and at 30 days.
- `GET https://swolecharts.com/api/hyperliquid/liquidations`: Probable Hyperliquid liquidations (tracked wallets): totals, per coin, largest, hourly.
- `GET https://swolecharts.com/api/funding-persistence`: Settled funding sign streaks and reversals, top 50 perps by OI.
- `GET https://swolecharts.com/api/hyperliquid/buybacks`: Recorded daily HYPE buybacks. Chronological recorded days from the last 90 completed UTC days; no custom dates, addresses or limits. Source: https://swolecharts.com/hyperliquid/assistance-fund. generated_at_ms/day_start_ms: UTC epoch ms; hype_bought: HYPE; usd_spent: USD paid at recorded fills, not a current-price valuation; fill_count: fills, null if unavailable. recorded_days/expected_days: recorded coverage out of 90 days; coverage_days_30: recorded days out of 30. Missing days are absent; recorded zero-buy days remain zero. An incomplete window is not a complete history. CSV has the same rows with source, units and coverage comments. Works independently of live supply data. Cached for at most 600s, the remaining source memo lifetime, and never past UTC midnight. The site's data-use terms apply: published data/charts must link to swolecharts.com or the source page. Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/seasonality/{COIN}/volume`: Volume share by UTC hour and session. The coin's /seasonality page memo (one hourly load per coin and window, shared with the page and both formats; nothing reads spot_1h separately). 24 hour rows then 3 session rows, capped. mean_daily_volume_share: fraction of one complete UTC day's Binance spot quote volume (USDT) averaged over the eligible days, so 1/24 is an even hour; it is not the share of volume pooled over the window; hour_utc: UTC hour of the candle open, 0-23; eligible_days: complete UTC days for hour rows, complete weekdays for session rows; complete_utc_days: days with all 24 candles stored and positive volume; analysis_start_ms/analysis_end_ms: UTC epoch ms of the first and last hourly candle open in the window, also as analysis_start_utc/analysis_end_utc. Sessions are weekdays only and overlap, so their shares do not sum to 1; utc_hours states each session's daylight-saving rule. Full-precision fractions, no rounding. CSV: the same rows as row_type=hour|session with the window, source and units as comments. Cached at most as long as the page memo (3600 s). Source: https://swolecharts.com/seasonality. Past volume patterns are not a forecast. The site's data-use terms apply: published data/charts must link to swolecharts.com or the source page. Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/watch-strip`: Multi-coin price, funding and OI snapshot. server_ts: source snapshot time in epoch ms (nullable), not an individual price observation time; base: string; price: USD, nullable; chg24h/oi_24h: fractional 24h changes, nullable; funding_avg: fractional OI-weighted 8h-equivalent funding, nullable; Required c selects 1-20 distinct bases of 1-20 ASCII letters/digits, comma-separated; trim whitespace, uppercase, deduplicate and sort by base. Malformed tokens may be discarded when valid tokens remain; unknown bases are omitted. Empty snapshot or all-unknown selection returns 200 with an empty coins array. 400 for missing, empty or repeated c, no well-formed bases, more than 20 accepted bases or c over 440 characters. Anonymous, unmetered in-memory snapshot, no database read. Plain c requests have a five-second public cache; sessions, credentials or extra parameters make responses private/no-store. A key is unnecessary and unlocks no extra fields or higher tier. Example: curl 'https://swolecharts.com/api/watch-strip?c=BTC,ETH'. Empty example: {"server_ts":1792642000000,"coins":[]}.
- `GET https://swolecharts.com/api/home-majors`: BTC and ETH price cards of the home page. server_ts: source snapshot time in epoch ms (nullable), not an individual price observation time; majors[].base: BTC or ETH; market: venue, symbol and 'perp' of the largest-open-interest eligible perp (not HIP-3, not left out of OI totals, finite positive price), the one row all fields come from; price: USD; price_text: the price as the home page prints it; px_24h: fractional 24h change, nullable; px_24h_text: that change as printed (+1.23%, or a dash); px_24h_cls: up, down, z (unknown) or empty (zero); price_ts: source observation time of that row in epoch seconds, nullable (the minute bar's open). majors is empty while the snapshot is still cold after a restart, and omits a coin without an eligible perp. Rows are never averaged across venues and never invented. Anonymous, unmetered in-memory snapshot, no database read. A plain request has a five-second public cache; sessions, credentials, any query parameter or any method other than GET and HEAD make responses private/no-store. A key is unnecessary and unlocks no extra fields or higher tier. Example: curl 'https://swolecharts.com/api/home-majors'. Empty example: {"server_ts":1792642000000,"majors":[]}.
- `GET https://swolecharts.com/api/market-movers`: 24h movers: price, OI, long/short, funding, liquidations; top 5 per list. as_of/sections.*.as_of: epoch ms; each section contains up/down lists (down null when unavailable and always null for liquidations), unavailable reason or null, nullable note, unit; rows contain base, venue, symbol, value, coin_url (nullable). Price/OI/long-short values are fractions; funding is fraction per 8h; liquidations are USD (venue/symbol empty for coin aggregates). sectors: best/worst /sectors category by median 24h price change (fractions; oi_24h nullable; n coins with a known change), null when fewer than 3 categories have 4 such coins. TTL 5s. Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/state`: Site live feed (alerts, feed status); unversioned. server_ts: epoch ms; uptime: seconds. Internal feed of the scanner page: fields can change without notice and carry no version.
- `GET https://swolecharts.com/api/liquidations/daily`: Daily long/short liquidation totals. Shaped like /api/series: t/start/end: UTC day start, epoch ms; step: ms (1 day); long/short: USD.
- `GET https://swolecharts.com/api/liquidations/window`: Rolling-window liquidations by venue and coin. since/until/as_of/buckets.t: epoch ms; buckets.step: ms; total/long/short: USD. CORS: *.
- `GET https://swolecharts.com/api/liquidations/heatmap`: Liquidations per coin and time bucket. t/start/end/as_of/tracked_from: epoch ms; step: ms; values: one row per coin, oldest bucket first, USD or count.
- `GET https://swolecharts.com/api/funding/oi-weighted`: Market OI-weighted and mean funding index. oiw/avg: fraction per 8h; t/start/end: epoch ms; step: ms (hourly up to 30d, daily beyond).
- `GET https://swolecharts.com/api/funding-changes`: Matched recorded funding quote changes. start_fraction/end_fraction: quoted fractions per 8h, not settlements; change_pp: pp (percentage points); oi_usd: USD; *_ms: epoch ms. Up/down capped at 25 each; flat/unavailable at 50. TTL 120s. X-RateLimit-* headers; 401 invalid key; 429 exhausted budget with Retry-After.
- `GET https://swolecharts.com/api/funding-averages`: Each coin's 1d, 7d and 30d mean funding. coins: {coin: [1d, 7d, 30d averages (fraction per 8h, null if none), then each window's recorded hours when partial, else null]}; hours: window lengths.
- `GET https://swolecharts.com/api/exchanges/market-share`: Daily exchange share of perp OI and volume. t/first_data/markers.t/as_of: epoch ms (t: UTC day start); *_usd: USD; *_share: 0..1, null without data.
- `GET https://swolecharts.com/api/open-interest/total`: Daily total perp OI, all coins. Shaped like /api/series: t/as_of: epoch ms (t: UTC day start); step: ms; v: USD, MEXC excluded; gaps: [start, end) epoch ms of days without data.
- `GET https://swolecharts.com/api/open-interest/altcoins`: Daily altcoin perp OI (ex BTC, ETH) and BTC share of total OI. Shaped like /api/series: t/as_of: epoch ms (t: UTC day start); step: ms; v: USD; btc_share: BTC OI / total OI (0..1, null for zero total). MEXC excluded. Only days recorded for all coins, BTC and ETH are included; gaps: [start, end) epoch ms of missing days. 2y aliases all.
- `GET https://swolecharts.com/api/perp-volume/total`: Daily total perp volume, all coins. Shaped like /api/series: t/as_of: epoch ms (t: UTC day start); step: ms; v: USD, MEXC included; gaps: [start, end) epoch ms of days without data.
- `GET https://swolecharts.com/api/hyperliquid/hip3-dexes/volume/history`: Daily recorded volume by HIP-3 dex: last 30 complete UTC days plus today. t/start/end/today: epoch ms; v: total USD notional; volume:{dex}: dex USD notional; share[dex] and share:{dex}: fractions of recorded daily total. hours/market_hours/expected_market_hours: per-dex arrays; null means unrecorded. Coverage uses markets observed that day; missing markets or hours can bias shares. Cached 120s.
- `GET https://swolecharts.com/api/hyperliquid/open-interest/history`: Hyperliquid OI history, native and HIP-3. Shaped like /api/series: v/native/hip3: USD; t/start/end: epoch ms; step: ms. Per-market last recorded OI within each bucket, then sum; no carry-forward. Bucket timestamps are not daily closes; missing markets can understate coverage. CSV comments include source URL, requested range, step, units and known/unknown gaps. Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/hyperliquid/cohorts/{COIN}`: Hyperliquid cohort net positions. range and range_s: integer seconds; range_label: e.g. 7d; t: epoch ms; step: ms; one net USD column per cohort in fields (dim=ls: accounts_long and value_long, 0-100, null for a missing hour).
- `GET https://swolecharts.com/api/hyperliquid/whales`: Hyperliquid whale positions and moves. as_of/checked_at/at: epoch ms; positions: the 100 largest tracked, largest first; liq_distance_pct: percent from the mark, null once crossed; moves: $250K+ changes to $1M+ positions in the last 12h, newest first, at most 50. Refreshed every 5 min; tracked wallets only.
- `GET https://swolecharts.com/api/futures-term-structure/history`: Quarterly futures basis history. front/next: annualized basis, percent; t/start/end/marks.t: epoch ms; step: ms. Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/coins/compare/{A}-vs-{B}`: Two coins' price or OI, rebased to 100. Unknown coin: 404. a/b: 100 at the first common bucket; t: epoch ms; step: ms (hourly to 30d, 4-hourly for 90d). Shared key/IP request budget and X-RateLimit-* headers, as /api/series; 401 for invalid keys, 429 with Retry-After when exhausted. A key raises the request budget only; data ranges and point limits are unchanged.
- `GET https://swolecharts.com/api/liquidation-levels/{COIN}`: Model estimate (model_version): levels, max pain. as_of: epoch ms; price, bin_width and levels: USD; model_version: the model that made them.
- `GET https://swolecharts.com/api/liquidation-heatmap/{COIN}`: Model estimate (version): liquidation heatmap. start/end/as_of/t0: epoch ms; step/dt: ms; y0/price: USD; cells: base64 grid, one byte per cell scaled to cap (USD).
- `GET https://swolecharts.com/api/liquidity-heatmap/{COIN}`: Measured resting order-book depth by price. t0: epoch ms; dt: ms; y0/px: USD; cells: encoded depth grid scaled to cap.
- `GET https://swolecharts.com/api/contract-changes`: Perp listings, delistings, contract changes (30d). as_of: ISO 8601 UTC string of request time; as_of_ms/generated_at_ms: epoch ms; event time and delist_time: ISO 8601 UTC.
- `GET https://swolecharts.com/api/sectors`: Seven futures sectors, as /sectors.csv. as_of: epoch ms; snapshot_utc: ISO 8601 UTC time of the hub snapshot; funding_8h_pct: percent, OI-weighted funding per 8 hours; *_usd: USD; *_pct: percent; coins: coins in the sector; coins_with_*: coins with data for that column.
- `GET https://swolecharts.com/coins.json`: Coin index behind /coins (column-major). server_ts: epoch ms; vol/oi/liq: whole USD; fund: fraction per 8h; ch/oi1/oi24: fractions; venues and cat: indexes into vn and cn.

## Plain-text board

- `GET https://swolecharts.com/now.txt`: Top perps by open interest as a plain-text table, at most 80 columns: price, 24h change, OI (USD), OI 24h change and 8h funding, with a UTC snapshot time. For curl, watch, tmux and scripts. Params: c: 1-20 coins, e.g. BTC,ETH; n: rows, 1-50. A dash is a missing or stale value. Same keyless per-IP budget as /api/series.

## CSV downloads (templates, not live links)

- `GET https://swolecharts.com/api/series/{METRIC}?format=csv`: same data as the JSON, as CSV (time_utc, unix_ms, one column per field).
- `GET https://swolecharts.com/api/hyperliquid/buybacks?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/api/seasonality/{COIN}/volume?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/api/liquidations/daily?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/api/liquidations/heatmap?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/api/exchanges/market-share?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/api/hyperliquid/open-interest/history?format=csv`: same data as the JSON, as CSV.
- `GET https://swolecharts.com/exchanges/{venue}/contracts?format=csv`: every recorded active perpetual contract, specs and live funding, open interest and volume. Params: sort, dir; all rows regardless of page.
- `GET https://swolecharts.com/hyperliquid/stocks/weekend/{YYYY-MM-DD}?format=csv`: HIP-3 weekend perp mark observations by builder-prefixed symbol, estimated funding and bucket coverage. Params: date is a stored Friday.
- `GET https://swolecharts.com/spike-stats/week/{YYYY-Www}?format=csv`: published weekly volume-spike summary, directional breakdowns or five biggest spikes. Params: table=summary (default)|venue|level|direction|segment|top.
- `GET https://swolecharts.com/funding-rates.csv`: current funding snapshot per coin and perpetual market, with interval and 8h-equivalent rates.
- `GET https://swolecharts.com/open-interest.csv`: current open-interest snapshot per coin and perpetual market, with excluded OI flagged.
- `GET https://swolecharts.com/open-interest-concentration?format=csv`: covered eligible coin OI concentration, venue shares, HHI (0..1) and implied same-contract 24h share shifts in percentage points. Params: coin (exact symbol; default up to 100 ranked and 100 limited-coverage coins).
- `GET https://swolecharts.com/volume-concentration?format=csv`: recorded rolling 24h volume concentration across covered eligible exchanges, approximate USD-comparable volume, venue shares and HHI (0..1). Params: market=spot (default)|perp; coin (exact symbol; default up to 100 ranked and 100 limited-coverage coins).
- `GET https://swolecharts.com/sectors.csv`: the seven futures sectors: open interest, 24h OI change, OI-weighted funding, volume, median price change and OI share, with coin coverage counts; sectors overlap.
- `GET https://swolecharts.com/open-interest-screener?format=csv`: ranked coin open-interest, price and funding changes over a window. Params: window, venue.
- `GET https://swolecharts.com/gainers-losers?format=csv`: ranked gainers, losers and HIP-3 price movers with open-interest changes, funding and volume. Params: window=1h|4h|24h.
- `GET https://swolecharts.com/open-interest/market-cap-ratio?format=csv`: coins ranked by perp open interest as a percentage of CoinGecko market cap.
- `GET https://swolecharts.com/funding-rates/heatmap?format=csv`: current funding rate per coin and exchange.
- `GET https://swolecharts.com/funding-rates/accumulated?format=csv`: funding accumulated per coin over a window. Params: window.
- `GET https://swolecharts.com/funding-rates/quote-comparison?format=csv`: USDT vs USDC perpetual funding on matched pairs. Params: venue.
- `GET https://swolecharts.com/funding-basis-disagreement?format=csv`: up to 50 fresh same-venue Binance/Bybit USDT funding-versus-basis sign disagreements, ranked by absolute basis, with quoted 8h-equivalent funding and both price source times.
- `GET https://swolecharts.com/funding-arbitrage/settled-history?format=csv`: daily settled-funding carry per leg for one coin and direction. Params: base, direction.
- `GET https://swolecharts.com/liquidations/history?format=csv`: daily liquidation totals, longs vs shorts, with a column set per exchange. Params: window, venue, coin.
- `GET https://swolecharts.com/liquidations/monthly/{YYYY-MM}?format=csv`: one monthly liquidation report table (days by default). Params: table=days|coins|top|exchanges.
- `GET https://swolecharts.com/crypto-correlation?format=csv`: per-coin beta to BTC, volatility and the correlation matrix. Params: window.
- `GET https://swolecharts.com/returns?format=csv`: month-to-date, previous-month and year-to-date returns for every coin.
- `GET https://swolecharts.com/returns/{COIN}?format=csv`: one coin's monthly, quarterly and yearly returns.
- `GET https://swolecharts.com/best-performing-crypto?format=csv`: rolling 7-day, 30-day, 90-day and 1-year returns per coin and each gap to Bitcoin. Params: sort=7d|30d|90d|1y.
- `GET https://swolecharts.com/price-history/{COIN}.csv`: one coin's daily open, high, low, close, quote volume and daily change since listing.
- `GET https://swolecharts.com/moving-average/{COIN}.csv`: one coin's daily close with its 20/50/100/200-day SMA and EMA.
- `GET https://swolecharts.com/dca/{COIN}?format=csv`: each buy of a dollar-cost averaging backtest at the UTC daily close, with running totals. Params: amount, every=day|week|month, years or start=YYYY-MM-DD.
- `GET https://swolecharts.com/calculators/settled-funding?format=csv`: hypothetical settled Binance funding payments of a fixed BTC, ETH or SOL long or short over selected completed UTC days, with native rate, recorded mark and signed cashflow. Params: coin, side=long|short, qty, start and end=YYYY-MM-DD UTC boundaries of the last recorded seven days.
- `GET https://swolecharts.com/crypto-volatility/{COIN}?format=csv`: one coin's daily 30/60/90-day realised volatility.
- `GET https://swolecharts.com/market-states?format=csv`: price, open-interest and exposure change per recorded market state for one perpetual. Params: market, range.
- `GET https://swolecharts.com/options/oi-changes?format=csv`: options open-interest change per expiry, calls and puts. Params: coin.
- `GET https://swolecharts.com/bitcoin-halving.csv`: bitcoin price multiple of the halving close, by days since each halving.
- `GET https://swolecharts.com/bitcoin-vs-gold.csv`: bitcoin and gold (PAXG) daily closes, bitcoin in gold ounces and 30/90-day correlation.
- `GET https://swolecharts.com/bitcoin-vs-m2.csv`: BTC month-end price, US M2 level and YoY growth, BTC per trillion US M2 and 12/24-month correlation.
- `GET https://swolecharts.com/bitcoin-wikipedia-pageviews.csv`: Weekly English Wikipedia Bitcoin views and Sunday BTCUSDT close (Wikimedia CC0).
- `GET https://swolecharts.com/bitcoin-vs-sp500.csv`: BTC, Hyperliquid SP500 and XYZ100 perpetual weekday closes, ratio, indexed performance and 30/90-day correlation.
- `GET https://swolecharts.com/ratio/{slug}.csv`: native Binance cross-pair daily ratio close, high, low and 50/200-day moving averages. Params: slug: eth-btc, sol-btc, sol-eth, xrp-btc, bnb-btc, doge-btc, ada-btc, link-btc.
- `GET https://swolecharts.com/cme-gap.csv`: estimated bitcoin CME weekend gaps since 2019 (Binance spot at CME session times), fill date and days to fill.
- `GET https://swolecharts.com/cme-gap/eth.csv`: estimated ether CME weekend gaps since 2019 (Binance spot at CME session times), fill date and days to fill.
- `GET https://swolecharts.com/bitcoin-cycle-indicators/{SLUG}.csv`: one bitcoin cycle indicator's daily series.
- `GET https://swolecharts.com/reports/{PERIOD}/{TABLE}.csv`: one table of a weekly or monthly market report; TABLE is one of open-interest, open-interest-venues, funding, liquidations, liquidation-days, volume, hyperliquid.
- `GET https://swolecharts.com/funding-rates/calendar.ics`: funding settlement times as an iCalendar file.
- `GET https://swolecharts.com/options/{coin}/expiry.ics`: one exact listed BTC/ETH options expiry with an optional local-calendar reminder. Params: coin=btc|eth; expiry=YYYY-MM-DD (required, future listed date); remind=none|60 (default none); stale source returns 503.
- `GET https://swolecharts.com/futures-term-structure/{BASE}/expiry.ics`: one recorded Binance or Bybit dated-futures contract's expiry as a calendar event. Params: venue=binance|bybit and symbol=exact contract (both required); no recording in the last 3 hours returns 503, an elapsed expiry 410.
- `GET https://swolecharts.com/candle-close/calendar.ics`: recurring UTC daily, Monday weekly or first-of-month candle closes; calendar-controlled reminders. Params: period=day|week|month (default day), remind=none|5 (default none).
- `GET https://swolecharts.com/crypto-economic-calendar.ics`: upcoming FOMC decisions and options and CME Bitcoin futures expiries as an iCalendar file.

## MCP server

- MCP endpoint (Streamable HTTP, read-only, no account): `https://swolecharts.com/mcp`
- [MCP server card](https://swolecharts.com/.well-known/mcp/server-card.json): machine-readable server and tool discovery.
- [How to connect](https://swolecharts.com/developers/mcp)

## RSS feeds

- `https://swolecharts.com/liquidations/big.xml`: large liquidations of the last 24 hours (singles and 5-minute cascades), newest first, for feed readers and Discord/Slack RSS bots
- `https://swolecharts.com/liquidations/daily/rss.xml`: one entry per day: the day's liquidation totals and biggest events
- `https://swolecharts.com/funding-rates/daily/rss.xml`: one entry per day: the funding-rate recap
- `https://swolecharts.com/market-movers/daily/rss.xml`: one entry per day: the biggest daily market movers
- `https://swolecharts.com/volume-spikes/rss.xml`: archived volume spikes
- `https://swolecharts.com/hyperliquid/stocks/weekends/rss.xml`: Hyperliquid HIP-3 weekend stock-perp recaps
- `https://swolecharts.com/contract-changes/rss.xml`: perpetual contract listings, delistings and parameter changes
- `https://swolecharts.com/reports/rss.xml`: periodic market reports

## Embeds, badges and oEmbed

- Free, no key: pick a widget at [https://swolecharts.com/widgets](https://swolecharts.com/widgets), copy its iframe snippet and keep the credit link under it. Add `?theme=light` or `?theme=dark` to the iframe URL.
- Iframe paths on https://swolecharts.com (templates, not live links): `/embed/funding/{BASE}`, `/embed/liquidations`, `/embed/spikes`, `/embed/chart/{BASE}/{METRIC}`, `/embed/altcoin-season`, `/embed/perp-dex`, `/embed/fear-greed`, `/embed/funding-arbitrage`, `/embed/funding-breadth`, `/embed/hip3`, `/embed/market-movers`, `/embed/options/{btc|eth}`, `/embed/kimchi-premium`, `/embed/hyperliquid-whale-moves`, `/embed/btc-flow`, `/embed/coins/{A}-vs-{B}`.
- Badges (templates, not live links): `https://swolecharts.com/badge/{funding|oi}/{BASE}.svg`.
- Market-wide badges: `https://swolecharts.com/badge/fear-greed.svg`, `https://swolecharts.com/badge/altcoin-season.svg`.
- oEmbed: `https://swolecharts.com/oembed?url=<page URL>&format=json` (JSON only) returns the iframe snippet for widget-backed pages such as /liquidations, /funding-arbitrage, /coin/{BASE}/open-interest and /options/btc; those pages advertise it with a discovery link.

## Methodology and data accuracy

- [Data accuracy](https://swolecharts.com/data-accuracy): how each number is made and how closely it matches exchanges
- [Liquidation heatmap methodology](https://swolecharts.com/methodology/liquidation-heatmap)
- API terms: attribution required, no resale of raw feeds (see /developers)