REST API
Base URL: https://api.trinityinsights.io. The paths below are absolute on this host and already carry the /api/v1 prefix.
The Trinity Insights REST API is versioned at /api/v1, authenticated by API key (X-API-Key header), and organized by domain. This page lists all public endpoints, grouped by functional domain. The reference is generated automatically from the OpenAPI specification.
Core endpoints
| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /api/v1/indicators | List Indicators | Key |
| GET | /api/v1/indicators/{slug} | Get Indicator | Key |
| GET | /api/v1/indicators/{slug}/data | Get Indicator Data | Key |
| GET | /api/v1/regime/current | Get Current Regime | Key |
| GET | /api/v1/regime/history | Get Regime History | Key |
| GET | /api/v1/scores/{indicator}/history | Get Indicator History | Key |
| GET | /api/v1/scores/{indicator}/latest | Get Indicator Latest | Key |
| GET | /api/v1/scores/{indicator}/page-payload | Get Indicator Page Payload | Key |
| GET | /api/v1/scores/detailed | Get Detailed Scores | Key |
| GET | /api/v1/scores/insights-lab | Get Insights Lab | Key |
| GET | /api/v1/scores/latest | Get Latest Scores | Key |
Intelligence
| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /api/v1/cycle-intelligence/catalog | List Cycle Catalog | Key |
| GET | /api/v1/cycle-intelligence/categories | List Cycle Categories | Key |
| GET | /api/v1/cycle-intelligence/metrics/{metric_id}/data | Get Cycle Metric Data | Key |
| GET | /api/v1/cycle-intelligence/pipeline/status | Get Cycle Pipeline Status | Key |
| GET | /api/v1/exchange-intelligence/families | List Families | Key |
| GET | /api/v1/exchange-intelligence/families/{family} | List Family Charts | Key |
| GET | /api/v1/exchange-intelligence/metrics | List Metrics | Key |
| GET | /api/v1/exchange-intelligence/metrics/{metric_id}/data | Get Metric Data | Key |
| GET | /api/v1/exchange-intelligence/metrics/{metric_id}/metadata | Get Metric Metadata | Key |
| GET | /api/v1/macro-intelligence/catalog | List Macro Catalog | Key |
| GET | /api/v1/macro-intelligence/categories | List Macro Categories | Key |
| GET | /api/v1/macro-intelligence/events | List Macro Events | Key |
| GET | /api/v1/macro-intelligence/metrics/{metric_id}/data | Get Macro Metric Data | Key |
| GET | /api/v1/macro-intelligence/pipeline/status | Get Macro Pipeline Status | Key |
| GET | /api/v1/macro-intelligence/sentinel/status | Get Sentinel Macro Status | Key |
| GET | /api/v1/narrative-intelligence/catalog | List Narrative Catalog | Key |
| GET | /api/v1/narrative-intelligence/categories | List Narrative Categories | Key |
| GET | /api/v1/narrative-intelligence/metrics/{metric_id}/data | Get Narrative Metric Data | Key |
| GET | /api/v1/onchain/catalog | List Onchain Catalog | Key |
| GET | /api/v1/onchain/categories | List Onchain Categories | Public |
| GET | /api/v1/onchain/cohort-conviction/{slug} | Get Cohort Conviction | Key |
| GET | /api/v1/onchain/events | List Onchain Events | Key |
| GET | /api/v1/onchain/metrics/{metric_id}/data | Get Onchain Metric Data | Key |
| GET | /api/v1/onchain/pipeline/status | Get Pipeline Status | Key |
| GET | /api/v1/onchain/urpd/{slug}/{date} | Get Onchain Urpd Payload | Key |
| GET | /api/v1/onchain/urpd/{slug}/clusters/{date} | Get Onchain Urpd Clusters | Key |
| GET | /api/v1/onchain/urpd/{slug}/dates | Get Onchain Urpd Dates | Key |
| GET | /api/v1/onchain/urpd/{slug}/latest_date | Get Onchain Urpd Latest Date | Key |
| GET | /api/v1/onchain/urpd/{slug}/range | Get Onchain Urpd Payload Range | Key |
| GET | /api/v1/price-intelligence/{asset}/{metric_id} | Get Metric Data | Key |
| GET | /api/v1/price-intelligence/{asset}/{metric_id}/intraday | Get Metric Intraday | Key |
| GET | /api/v1/price-intelligence/{asset}/klines | Get Intraday Klines | Key |
| GET | /api/v1/price-intelligence/{asset}/ohlcv | Get Ohlcv | Key |
| GET | /api/v1/price-intelligence/assets | List Assets | Public |
| GET | /api/v1/price-intelligence/categories | List Categories | Public |
| GET | /api/v1/price-intelligence/cross/{metric_id} | Get Cross Asset Metric | Key |
Advanced analytics
| Method | Path | Summary | Auth |
|---|---|---|---|
| DELETE | /api/v1/alerts/v2/{alert_id} | Delete Alert | Key |
| DELETE | /api/v1/alerts/v2/channels/{channel_type} | Delete Channel | Key |
| GET | /api/v1/alerts/v2 | List Alerts | Key |
| GET | /api/v1/alerts/v2/{alert_id} | Get Alert | Key |
| GET | /api/v1/alerts/v2/{alert_id}/history | Get Alert History | Key |
| GET | /api/v1/alerts/v2/channels | List Channels | Key |
| GET | /api/v1/alerts/v2/digest | Get Digest Preferences | Key |
| GET | /api/v1/alerts/v2/metrics | List Alertable Metrics | Key |
| GET | /api/v1/alerts/v2/metrics/{category}/{key}/thresholds | Get Metric Thresholds | Key |
| GET | /api/v1/alerts/v2/templates | List Templates | Key |
| GET | /api/v1/backtest/runs | List Backtest Runs | Key |
| GET | /api/v1/conviction/current | Get Current Conviction | Key |
| GET | /api/v1/conviction/history | Get Conviction History Endpoint | Key |
| GET | /api/v1/factor/saved | List Saved Factors | Key |
| GET | /api/v1/foresight/calibration/{asset}/{timeframe} | Get Foresight Calibration | Key |
| GET | /api/v1/foresight/chunks/{chunk_id} | Get Foresight Chunk | Key |
| GET | /api/v1/foresight/history/{asset}/{timeframe} | Get Foresight History | Key |
| GET | /api/v1/foresight/manifest/{asset}/{timeframe} | Get Foresight Manifest | Key |
| PATCH | /api/v1/alerts/v2/{alert_id} | Update Alert | Key |
| POST | /api/v1/alerts/v2 | Create Alert | Key |
| POST | /api/v1/alerts/v2/{alert_id}/snooze | Snooze Alert | Key |
| POST | /api/v1/alerts/v2/{alert_id}/test | Test Alert | Key |
| POST | /api/v1/alerts/v2/{alert_id}/unsnooze | Unsnooze Alert | Key |
| POST | /api/v1/alerts/v2/channels/{channel_type}/test | Test Channel | Key |
| POST | /api/v1/alerts/v2/channels/discord | Save Discord Webhook | Key |
| POST | /api/v1/alerts/v2/channels/push | Save Push Subscription | Key |
| POST | /api/v1/alerts/v2/channels/slack | Save Slack Webhook | Key |
| POST | /api/v1/alerts/v2/channels/telegram/link | Link Telegram | Key |
| POST | /api/v1/alerts/v2/channels/telegram/verify | Verify Telegram | Key |
| POST | /api/v1/alerts/v2/channels/webhook | Save Custom Webhook | Key |
| POST | /api/v1/alerts/v2/from-template/{key} | Create From Template | Key |
| POST | /api/v1/alerts/v2/telegram/webhook | Telegram Webhook | Public |
| POST | /api/v1/backtest/run | Run Backtest | Key |
| POST | /api/v1/conviction/compute | Trigger Conviction Compute | Key |
| POST | /api/v1/factor/generate | Generate Factor | Key |
| PUT | /api/v1/alerts/v2/digest | Update Digest Preferences | Key |
On-chain specialized
| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /api/v1/cointime/metrics | List Cointime Metrics | Key |
| GET | /api/v1/cointime/metrics/{metric_id}/data | Get Cointime Metric Data | Key |
| GET | /api/v1/hyperliquid/all | All Hyperliquid data in one call - tier-filtered | Key |
| GET | /api/v1/hyperliquid/book-depth | Near-mid order-book depth - Hyperliquid vs Binance | Key |
| GET | /api/v1/hyperliquid/btc-price-history | BTC/USD price history - Binance public API (commercial use OK) | Key |
| GET | /api/v1/hyperliquid/clearinghouse | Hyperliquid clearinghouse state - institutional solvency monitor | Key |
| GET | /api/v1/hyperliquid/economics/overview | Protocol economics - measured AF buyback, implied revenue, supply dynamics | Key |
| GET | /api/v1/hyperliquid/economics/segments | Where protocol revenue comes from - measured total split by weighted segment volumes | Key |
| GET | /api/v1/hyperliquid/economics/valuation | HYPE valuation - buyback yield, P/S multiples, implied price bands | Key |
| GET | /api/v1/hyperliquid/etf/dashboard | HYPE spot ETF dashboard - universe, latest snapshot, ecosystem totals | Key |
| GET | /api/v1/hyperliquid/etf/history | HYPE spot ETF daily time series (per ticker, per metric) | Key |
| GET | /api/v1/hyperliquid/etf/history-all | HYPE spot ETF daily time series across all issuers (one metric) | Key |
| GET | /api/v1/hyperliquid/fear-greed/history | HL Fear & Greed Index historical scores for charting | Key |
| GET | /api/v1/hyperliquid/flippenings | HL vs CEX flippening registry - BTC-perp open interest per venue | Key |
| GET | /api/v1/hyperliquid/funding | Hyperliquid funding rates - aggregate heatmap (Free) or full matrix with per-market extremes (Pro) | Key |
| GET | /api/v1/hyperliquid/funding-arb | Cross-venue funding arbitrage - HL vs Binance vs Bybit annualised spread | Key |
| GET | /api/v1/hyperliquid/hip3 | HIP-3 tokenized assets - DEPRECATED; use /api/v1/hyperliquid/hip3/* (canonical builder-DEX router) | Key |
| GET | /api/v1/hyperliquid/hip3/aggregates | HIP-3 cumulative KPIs (all-time volume, trades) + volume history | Key |
| GET | /api/v1/hyperliquid/hip3/by-dex | HIP-3 per-DEX OI/volume + market share | Key |
| GET | /api/v1/hyperliquid/hip3/by-symbol | HIP-3 per-symbol breakdown for a given builder DEX | Key |
| GET | /api/v1/hyperliquid/hip3/dashboard | HIP-3 ecosystem dashboard - total OI, volume, per-DEX breakdown | Key |
| GET | /api/v1/hyperliquid/hip3/oi-trends | HIP-3 open interest time series (ecosystem or per-DEX) | Key |
| GET | /api/v1/hyperliquid/hip3/share | HIP-3 share of total HL perp volume + top markets by OI | Key |
| GET | /api/v1/hyperliquid/hip4/by-outcome | HIP-4 single-outcome drill-down - per-side probability + volume time series | Key |
| GET | /api/v1/hyperliquid/hip4/dashboard | HIP-4 prediction markets - outcomes with implied probabilities, volume | Key |
| GET | /api/v1/hyperliquid/hip4/history | HIP-4 ecosystem daily time series (aggregate volume + trades by snapshot) | Key |
| GET | /api/v1/hyperliquid/hlp | HLP vault counter-trade indication - Trinity-exclusive lecture | Key |
| GET | /api/v1/hyperliquid/hype/buy-pressure | HYPE structural buy pressure - AF buyback + ETF flows + DAT vs float | Key |
| GET | /api/v1/hyperliquid/hype/candles | HYPE OHLCV daily series | Key |
| GET | /api/v1/hyperliquid/hype/dashboard | HYPE token dashboard - structural, AF buyback, composite, bridges | Key |
| GET | /api/v1/hyperliquid/hype/history | HYPE daily time series (per allowed metric) | Key |
| GET | /api/v1/hyperliquid/leaderboard | Hyperliquid top traders leaderboard - aggregate (Free) or full drill-down (Pro) with Smart Money positioning lecture | Key |
| GET | /api/v1/hyperliquid/liquidations | Hyperliquid liquidations - three levels: ecosystem health (Free), 24h radar (Pro), real-time feed (Performance) | Key |
| GET | /api/v1/hyperliquid/market | Hyperliquid market overview - OI, volume, Fear & Greed Index | Key |
| GET | /api/v1/hyperliquid/market-history | HL perp market KPI time-series - OI, volume, funding, volatility proxy | Key |
| GET | /api/v1/hyperliquid/vaults | Hyperliquid vault scanner with Vault Alpha Score | Key |
| GET | /api/v1/old-coins/count | Old Coin Count | Key |
| GET | /api/v1/old-coins/events | Old Coin Events | Key |
Real-time streaming
| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /api/v1/stream/scores | Stream Scores | Key |
| GET | /api/v1/stream/scores/snapshot | Scores Snapshot | Key |
Account & billing
| Method | Path | Summary | Auth |
|---|---|---|---|
| DELETE | /api/v1/users/me | Delete My Data | Key |
| DELETE | /api/v1/users/me/api-keys/{key_id} | Revoke API key | Key |
| GET | /api/v1/invoices | List Invoices | Key |
| GET | /api/v1/paddle/prices | Get Paddle Prices | Public |
| GET | /api/v1/referrals/code | Get Referral Code | Key |
| GET | /api/v1/referrals/stats | Get Stats | Key |
| GET | /api/v1/trial/status | Trial Status | Key |
| GET | /api/v1/users/me | Get Me | Key |
| GET | /api/v1/users/me/api-keys | List my API keys | Key |
| GET | /api/v1/users/me/export | Export My Data | Key |
| GET | /api/v1/users/me/newsletter-preferences | Get Newsletter Preferences | Key |
| PATCH | /api/v1/users/me/newsletter-preferences | Update Newsletter Preferences | Key |
| POST | /api/v1/billing-portal | Create Billing Portal | Key |
| POST | /api/v1/billing/withdrawal-request | Request Withdrawal | Key |
| POST | /api/v1/consent | Record Consent | Key |
| POST | /api/v1/paddle/ensure-customer | Ensure Paddle Customer | Key |
| POST | /api/v1/referrals/link | Link To Referrer | Key |
| POST | /api/v1/users/me/api-keys | Create API key | Key |
| POST | /api/v1/users/me/api-keys/{key_id}/rotate | Rotate API key | Key |
MCP proxy via REST
| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /api/v1/mcp/tools | Discover available MCP tools | Key |
| POST | /api/v1/mcp/call | Invoke an MCP tool | Key |
Legacy endpoints (compat)
| Method | Path | Summary | Auth |
|---|---|---|---|
| DELETE | /api/v1/alerts/{alert_id} | Delete Alert | Key |
| GET | /api/v1/alerts | List Alerts | Key |
| GET | /api/v1/alerts/stream | Stream Alerts | Key |
| GET | /api/v1/alerts/stream/status | Stream Status | Key |
| GET | /api/v1/cycle/compare | Compare Cycles | Key |
| GET | /api/v1/cycle/history | Get Cycle History | Key |
| GET | /api/v1/cycle/position | Get Cycle Position | Key |
| GET | /api/v1/macro/business-cycle | Get Business Cycle | Public |
| GET | /api/v1/macro/business-cycle/history | Get Business Cycle History | Public |
| GET | /api/v1/macro/correlations | List Correlations | Key |
| GET | /api/v1/macro/correlations/{pair} | Get Correlation Detail | Key |
| PATCH | /api/v1/alerts/{alert_id} | Update Alert | Key |
| POST | /api/v1/alerts | Create Alert | Key |
| POST | /api/v1/macro/compute | Trigger Correlation Compute | Key |
Institutional disclaimer
Trinity Insights is an educational and analytical tool. Content does not constitute investment advice. Trinity Insights is not a Crypto-Asset Service Provider (CASP) registered under MiCA Regulation (EU) 2023/1114, nor a Financial Investment Advisor (CIF), nor a PSAN. See the full disclaimer.