REST API
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/scores/{indicator}/history | Get Indicator History | Key |
| GET | /api/scores/{indicator}/latest | Get Indicator Latest | Key |
| GET | /api/scores/detailed | Get Detailed Scores | Key |
| GET | /api/scores/insights-lab | Get Insights Lab | Key |
| GET | /api/scores/latest | Get Latest Scores | Key |
| 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/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/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/onchain/catalog | List Onchain Catalog | Key |
| GET | /api/v1/onchain/categories | List Onchain Categories | Public |
| 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/price-intelligence/{asset}/{metric_id} | Get Metric Data | 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/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/fear-greed/history | HL Fear & Greed Index historical scores for charting | Key |
| GET | /api/v1/hyperliquid/funding | Hyperliquid full funding rate matrix + extremes detection | Key |
| GET | /api/v1/hyperliquid/hip3 | HIP-3 tokenized stocks & ETFs — 24/7 price discovery | Key |
| GET | /api/v1/hyperliquid/hlp | HLP vault counter-trade signal — exclusive Trinity alpha | Key |
| GET | /api/v1/hyperliquid/leaderboard | Hyperliquid top traders leaderboard + Smart Money signal | Key |
| GET | /api/v1/hyperliquid/liquidations | Hyperliquid liquidation radar with hot coin clusters | Key |
| GET | /api/v1/hyperliquid/market | Hyperliquid market overview — OI, volume, Fear & Greed Index | 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 |
| POST | /api/v1/hyperliquid/fear-greed/backfill | Backfill F&G history from Hyperliquid funding data — admin only | Key |
| POST | /api/v1/hyperliquid/fear-greed/snapshot | Store current F&G score — called by pipeline or admin | 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 |
| POST | /api/v1/billing-portal | Create Billing Portal | 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 |
Inbound webhooks
| Method | Path | Summary | Auth |
|---|---|---|---|
| POST | /api/v1/webhooks/clerk | Clerk Webhook | Public |
| POST | /api/v1/webhooks/paddle | Paddle Webhook | Public |
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.