Loading
pour les utilisateurs payants. Accès programmatique aux signaux de trading, à l'intelligence de marché et aux surfaces d'exécution sur les 12 modules alpha. Référence des endpoints publics ci-dessous ; docs SDK complètes et schéma OpenAPI en cours.
1. Open public feeds. The unauthenticated feeds that power the website itself live under /api/* (for example /api/trade-feed/signals, /api/whales/activity/public, /api/congress/trades, /api/mre/signals, /api/mte/strategies). These require no key and are IP-rate-limited (~200 requests/minute). They are best-effort — the response shape can change without notice and they are not the supported contract. For a stable, keyed contract over the same data, use the /api/v1/* developer feeds below.
2. Gated developer API. The supported, versioned, tier-limited surface is the keyed /api/v1/* alpha feeds (trade-feed, mte, whales, congress, insider, aoe, mre, prediction), /api/v1/insider-alpha/* and /api/scorecards/*. All authenticate with an X-API-Key header (minted at Settings → API) and enforce per-tier daily, per-minute, and history-window limits. This is the layer documented in full below.
Tous les endpoints authentifiés acceptent un JWT dans l'en-tête X-API-Key: <your_key> header. As a fallback it also accepts an ?api_key= query parameter, but the header is strongly preferred so keys stay out of logs. A missing or invalid key returns 401; a revoked key returns 403.
Les endpoints sont Settings → API Keys. pour les tokens du palier gratuit. La page tarifs liste les modules inclus dans chaque plan.
Les limites de débit et les détails des abonnements WebSocket varient selon l'endpoint et le palier. Docs de référence complètes (schémas OpenAPI + WebSocket) à venir. /api/api-keys/tier-metadata.
These per-tier limits apply across the whole keyed developer API - the /api/v1/* alpha feeds, /api/v1/insider-alpha/*, and /api/scorecards/* - all gated on the same X-API-Key: free 100/day at 10 RPM, Plus 250/day at 20 RPM, Premium 5,000/day at 60 RPM, Quant 15,000/day at 180 RPM. Insider Alpha additionally delays filings 24h for free keys and serves them real-time to paid keys.
| Palier | Price | Requests / day | Requests / min | History window |
|---|---|---|---|---|
| Free | $0 | 100 | 10 | 30 days |
| Plus | $49/mo | 250 | 20 | 90 days |
| Premium | $99/mo | 5,000 | 60 | 1 year |
| Quant | $499/mo | 15,000 | 180 | 2 years |
All paths below are GET and require the X-API-Key header. Base URL: https://blockcircle.com
Trade Alpha unified signal feed - aggregated LONG/SHORT signals across AOE, Insider, MTE and manual sources with entry/exit prices and live PnL. Mirrors the open /api/trade-feed/signals feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/trade-feed?direction=LONG&status=OPEN&page_size=50"
{
"signals": [
{
"id": "6a1731885f1df19e60508d46",
"source": "AOE",
"source_detail": "AOE Outperformer",
"symbol": "0Y4G",
"direction": "LONG",
"entry_price": 46.6221,
"current_price": 46.6221,
"status": "CLOSED",
"pnl_pct": 0.0,
"signal_strength": 60,
"asset_type": "etf_index",
"timeframe": "1d",
"notes": "AOE Score: 81/100, Phase: PHASE_B",
"timestamp": "2026-05-27T18:01:44.318Z"
}
]
}MTE strategy listings - published backtester strategies with full performance blocks (PnL, Sharpe, win-rate, long/short split) and live webhook config. Mirrors the open /api/mte/strategies feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/mte?asset_class=stocks&tier=A&limit=50"
{
"items": [
{
"name": "MET MTE 1day",
"slug": "met-mte-1day",
"symbol": "MET",
"timeframe": "1day",
"asset_class": "stocks",
"tier": "A",
"source": "backtester",
"status": "active",
"performance": {
"total_pnl_pct": 152.14,
"win_rate": 100.0,
"total_trades": 26,
"sharpe": 1.32,
"sortino": 2.46,
"max_drawdown_pct": -8.46,
"score": 67.6
},
"signals": ["OPEN_LONG", "CLOSE_LONG"],
"created_at": "2026-07-05T01:32:32.089Z"
}
]
}Whale Alpha activity stream - large on-chain / prediction-market position changes with size, value and % change, plus a rollup summary. Mirrors the open /api/whales/activity/public feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/whales?hours=48&limit=50"
{
"activity": [
{
"_id": "6a4d7f674ab972374a0b7bb4",
"address": "0x2005d16a84cee...875ea",
"whale_name": "RN1",
"source": "polymarket",
"event_type": "size_increase",
"title": "Switzerland vs. Colombia: Team to Advance",
"outcome": "Colombia",
"size": 90684.7312,
"prev_size": 62913.2137,
"change_pct": 44.1,
"value": 45795.7892,
"created_at": "2026-07-07T22:36:01.849Z"
}
],
"total": 12794,
"summary": {
"entries": 3030, "exits": 3153,
"token_buys": 1029, "size_changes": 5582
}
}Political Alpha congressional & government trades - disclosed transactions across chambers/branches with politician, party, ticker, sector and dates. Mirrors the open /api/congress/trades feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/congress?ticker=NVDA&transaction_type=Purchase&page_size=50"
{
"trades": [
{
"id": "6a4d0d6ef164100b1f0d1937",
"politician_name": "Lloyd Doggett",
"party": "D",
"chamber": "House",
"state": "TX",
"asset_name": "The Home Depot Inc",
"ticker": "HD",
"asset_type": "Stock",
"sector": "consumer-discretionary",
"transaction_type": "Purchase",
"owner": "not-disclosed",
"transaction_date": "2026-06-18T00:00:00",
"filing_date": "2026-07-07T13:02:13",
"is_tradable": true
}
]
}Insider Alpha Form 4 filings - SEC insider transactions with insider role, issuer, direction and conviction/signal grading. Mirrors the open /api/insider-alpha/filings feed. (The richer, fully-filtered surface lives at /api/v1/insider-alpha/filings below.)
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider?transaction_type=buy&days_back=90&page_size=50"
{
"filings": [
{
"id": "6a4d7a6abc29e7cd43754350",
"ticker": "KEY",
"company_name": "KEYCORP /NEW/",
"insider_name": "BANK OF NOVA SCOTIA",
"insider_title": "",
"is_director": true,
"is_ten_percent": true,
"transaction_code": "D",
"transaction_type": "Disposition to issuer",
"transaction_direction": "other",
"filing_date": "2026-07-07T00:00:00+00:00",
"trade_date": "2026-07-07T00:00:00+00:00"
}
],
"total": 2,
"tier": "free"
}Asset Outperformer (AOE) rankings - the scanned universe scored on multi-timeframe outperformance vs BTC/ETH/SOL benchmarks, with composite score and market phase. Mirrors the open /api/outperformers/scan feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/aoe?asset_type=crypto&sort_by=composite_score&limit=100"
{
"items": [
{
"id": "69e9a1d118203b40f763226d",
"symbol": "RETIRE",
"name": "The Last Play",
"asset_type": "crypto",
"current_price": 0.00329373,
"market_cap_rank": 1863,
"perf_24h": 28.69,
"perf_7d": 37.14,
"perf_30d": 38.75,
"outperf_vs_btc_24h": 28.91,
"beats_btc_24h": true,
"composite_score": 10.0,
"market_phase": "PHASE_C",
"avg_outperformance": 70.55
}
]
}Market Reversal Engine (MRE) signals - oversold/overbought reversal detections with direction, type, expected move and confidence score. Mirrors the open /api/mre/signals feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/mre?limit=100"
{
"items": [
{
"_id": "6a4c8c5898a4fde9e43d1fe6",
"ticker": "KRAKEN:ETHUSD",
"ticker_display": "ETHUSD",
"price": "1759.34",
"interval": "15m",
"asset_class": "crypto",
"signal": {
"what": "oversold",
"direction": "LONG",
"type": "SCALP",
"condition": "Confirmed 5-minute break-out and AMS M6 shows weakness"
},
"expected_pct": 2.0,
"score": 85
}
],
"total": 2073
}Prediction-market warehouse - normalized markets across Polymarket, Kalshi, PredictIt, Manifold, Metaculus and Opinion, with prices, volume and liquidity. Mirrors the open /api/markets/warehouse feed.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/prediction?platforms=polymarket,kalshi&sort=volume_24h&limit=50"
{
"items": [
{
"market_id": "0x7412d284...272abe",
"platform": "polymarket",
"event_title": "World Cup Winner",
"question": "Will Egypt win the 2026 FIFA World Cup?",
"yes_price": 0.0,
"outcome_prices": [0.0, 1.0],
"volume": 158580818.67,
"volume_24h": 25057938.54,
"category_norm": "sports",
"active": true,
"end_date": "2026-07-20T00:00:00Z"
}
],
"total": 57677,
"platforms": {
"polymarket": 23093, "kalshi": 27017, "predictit": 504,
"manifold": 6535, "metaculus": 493, "opinion": 35
},
"has_more": true
}Most recent data point for a scorecard (ams | mrs | gls) at a timeframe. Any tier — no history-window check.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/scorecards/ams/latest?timeframe=1D"
{
"item": {
"id": "6a4d...c1e",
"scorecard": "ams",
"timeframe": "1D",
"timestamp": "2026-07-07T00:00:00Z",
"data": { "ams": 62.4, "btc_dominance": 51.2, "... ": "..." }
},
"scorecard": "ams",
"timeframe": "1D"
}Paginated time-series history, newest first. History depth is capped to your tier's window; undated calls are floored to that window server-side.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/scorecards/mrs/data?timeframe=1D&from=2026-06-01&limit=500"
{
"items": [
{
"id": "6a4d...c1e",
"scorecard": "mrs",
"timeframe": "1D",
"timestamp": "2026-07-07T00:00:00Z",
"data": { "mrs": 38.1, "...": "..." }
}
],
"total": 1240,
"scorecard": "mrs"
}Streamed CSV export of a scorecard series, tier history-window enforced. Only format=csv is supported today.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/scorecards/gls/export?timeframe=1W" -o gls.csv
# text/csv stream timestamp,timeframe,gls,... 2026-07-07T00:00:00Z,1W,104.2,... 2026-06-30T00:00:00Z,1W,103.8,...
Paginated Form 4 insider filings with a full filter set. Free keys see data delayed 24h; higher tiers see it real-time.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/filings?ticker=NVDA&transaction_type=buy&days_back=90"
{
"filings": [
{
"id": "671b...901",
"ticker": "NVDA",
"insider_name": "Jensen Huang",
"insider_title": "CEO",
"transaction_direction": "buy",
"transaction_code": "P",
"shares": 25000,
"value": 3200000,
"filing_date": "2026-04-15T14:30:00Z"
}
],
"total": 1,
"page": 0,
"page_size": 50,
"has_more": false,
"tier": "free",
"data_lag_hours": 24
}Searchable directory of insiders with lifetime buy/sell aggregates.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/insiders?q=huang&sort_by=total_buy_value"
{
"insiders": [
{
"slug": "jensen-huang",
"name": "Jensen Huang",
"filing_count": 42,
"total_buy_value": 3200000,
"total_sell_value": 128000000
}
],
"total": 1,
"page": 0,
"page_size": 50
}Company profile with rolling insider-flow windows and recent filings.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/companies/AAPL"
{
"ticker": "AAPL",
"windows": {
"30d": { "buy_value": 0, "sell_value": 4200000, "net": -4200000 },
"90d": { "buy_value": 120000, "sell_value": 9800000, "net": -9680000 }
},
"filings": [ { "insider_name": "...", "transaction_direction": "sell" } ]
}Cluster-buy detections: multiple insiders at one company buying inside a window.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/clusters?days_back=30&min_insiders=3"
{
"clusters": [
{
"ticker": "SMCI",
"insider_count": 4,
"total_value": 5100000,
"detected_at": "2026-07-02T00:00:00Z"
}
],
"total": 1,
"page": 0,
"page_size": 50,
"has_more": false
}Market-wide insider-flow rollups (24h / 7d / 30d) plus most-bought tickers.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/stats/market"
{
"last_24h": { "buy_value": 0, "sell_value": 0, "filings": 0 },
"last_7d": { "buy_value": 12400000, "sell_value": 88000000, "filings": 512 },
"last_30d": { "...": "..." },
"most_bought_7d": [ { "ticker": "NVDA", "value": 3200000, "count": 3 } ],
"tier": "free"
}Live quota check for the calling key — current RPM / daily counts and remaining allowance.
curl -H "X-API-Key: <your_key>" \ "https://blockcircle.com/api/v1/insider-alpha/usage"
{
"tier": "free",
"usage": {
"rpm_used": 2, "rpm_remaining": 8,
"daily_used": 17, "daily_remaining": 83
},
"reset_in_seconds": { "rpm": 60, "daily": 86400 }
}