API Documentation
Endpoint catalog
40 curated endpoints
Market Data & Discovery
Reference data for Polymarket + Kalshi markets, plus the discovery scanners that rank where attention is mispriced.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/markets | List active markets — limit / offset / category / platform / search filters |
| GET | /api/markets/categories/summary | Per-category rollup: market count, volume, average price |
| GET | /api/markets/negrisk-events | NegRisk event groups (mutually-exclusive outcome baskets) |
| GET | /api/markets/divergence | Cross-venue divergence pairs (Polymarket ↔ Kalshi context) |
| GET | /api/discovery/scan | Combinatorial mispricing scan across active markets |
| GET | /api/discovery/overlooked | Overlooked-market ranking (signal-rich, volume-light) |
| GET | /api/discovery/resolution-risk | Markets with elevated resolution-ambiguity risk |
| GET | /api/discovery/closing-soon | Markets approaching resolution, ranked |
| GET | /api/discovery/related/{market_id} | Related markets for a given market id |
Whale Intelligence
Large-participant flow on Polymarket: live feed, profiles, leaderboard, anomalies, and pending mempool activity.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/whales/feed | Large-trade event feed (most recent first) |
| GET | /api/whales/leaderboard | Smart-money leaderboard: volume, win rate, smart score |
| GET | /api/whales/anomalies | Statistically unusual orders and flow patterns |
| GET | /api/whales/consensus | Aggregate whale positioning (global view) |
| GET | /api/whales/profile/{address} | Per-wallet trade history and behavioral stats |
| GET | /api/whales/pending | Pending Polymarket transactions from the mempool monitor |
Calibration & Track Record
The live accuracy record of the Bravolytix ensemble — Brier scores with confidence-band splits, reliability curves, CLV, and mistake taxonomy.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/calibration/brier | Headline Brier + confident/hedged band split + vs-market breakdown |
| GET | /api/calibration/brier/rolling | Rolling-window Brier series |
| GET | /api/calibration/curve | Reliability (calibration) curve buckets |
| GET | /api/calibration/clv | Closing-line-value record vs market close |
| GET | /api/calibration/edge | Win-rate and expected-value decomposition |
| GET | /api/calibration/edge/sweet-spots | Category / horizon pockets where the edge concentrates |
| GET | /api/calibration/skill | Skill-vs-luck significance test |
| GET | /api/calibration/mistakes | Mistake taxonomy over resolved predictions |
AI Ensemble Estimates
Calculator outputs from the multi-model ensemble. Estimates are calculator outputs, not recommendations.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/ai/estimate/{market_id} | Ensemble probability estimate + per-model components |
| GET | /api/ai/estimates/batch | Bulk estimates for a market list |
| GET | /api/ai/confidence/{market_id} | Model agreement and dispersion for one market |
| GET | /api/ai/model-agreement | Cross-model consensus metrics (aggregate) |
| GET | /api/ai/scan | Markets where the ensemble diverges most from price |
Cross-Venue Arbitrage
Structural mispricing surfaces across venues and NegRisk baskets.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/analytics/arb/scan | Cross-platform mispricing scan |
| GET | /api/analytics/arb/negrisk | NegRisk basket pricing violations |
| GET | /api/analytics/arb/stats | Scanner aggregate stats (depth, spread distribution) |
| GET | /api/analytics/arb/{market_id}/cross-platform | Per-market venue price deltas |
Bulk Export
Async export jobs over the raw datasets (markets, trades, orderbook, predictions, price_history, whale_alerts) — CSV or JSON, up to 2,000,000 rows per job.
| Method | Path | Purpose |
|---|---|---|
| POST | /api/export/bulk | Create an export job — body: { dataset, format, filters } |
| GET | /api/export/bulk | List your export jobs |
| GET | /api/export/bulk/{job_id}/status | Job progress (poll-friendly) |
| GET | /api/export/bulk/{job_id}/download | Stream the completed export file |
SLA & Usage
Service-level reporting for your org plus per-key usage accounting.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/sla/report | Uptime / latency SLA report (hours=1..720) |
| GET | /api/sla/endpoints | Per-endpoint latency breakdown |
| GET | /api/sla/timeseries | Bucketed latency / request series for charting |
| GET | /api/usage/summary | Aggregated request counts + latency across your keys |
A machine-readable OpenAPI schema for the curated surface is available from Bravolytix on request (support@yeldo.io). Every endpoint above is read-only analytics over public market data — Bravolytix executes no trades, holds no keys, and custodies no funds. Calculator output, not a recommendation.