API Documentation
Programmatic access to the VNX calculator surface — the curated institutional endpoint set. Calculator output, not a recommendation. Read-only · No execution · CFTC 4.14(a)(9).
Authentication
Base URL:
https://api.vonotix.comEvery request carries an API key in either header form:
Authorization: Bearer vnx_<64-hex-chars> X-API-Key: vnx_<64-hex-chars>
Keys are org-level under your license (no per-user accounts) and are created, rotated, and revoked in Settings → API — the plaintext key is shown once at creation. Scopes:
read covers every GET endpoint below; write covers export-job creation and key management.Rate limits
50,000 requests per hour per license (sliding window, shared across your org's keys). Every response carries
X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; exceeding the window returns 429 with a Retry-After header. Track burn via GET /api/usage/summary?hours=1.Endpoint catalog
45 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 VNX 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 |
API Key Management
Self-service key lifecycle — also available in the UI under Settings → API.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/keys | List your org's API keys (prefix, scopes, last used) |
| POST | /api/keys | Create a key — body: { name, scopes } (plaintext shown once) |
| POST | /api/keys/{key_id}/rotate | Rotate: revoke old, mint new with same metadata |
| DELETE | /api/keys/{key_id} | Revoke a key |
| GET | /api/keys/{key_id}/usage | Per-key request log (endpoint, status, latency) |
Quick start
# List active markets (either auth header form works)
curl -H "Authorization: Bearer vnx_<your-key>" \
"https://api.vonotix.com/api/markets?limit=50&platform=kalshi"
curl -H "X-API-Key: vnx_<your-key>" \
"https://api.vonotix.com/api/ai/estimate/<market_id>"
# Bulk export flow: create -> poll -> download
curl -X POST -H "X-API-Key: vnx_<your-key>" -H "Content-Type: application/json" \
-d '{"dataset":"trades","format":"csv"}' \
"https://api.vonotix.com/api/export/bulk"
curl -H "X-API-Key: vnx_<your-key>" \
"https://api.vonotix.com/api/export/bulk/<job_id>/status"
curl -OJ -H "X-API-Key: vnx_<your-key>" \
"https://api.vonotix.com/api/export/bulk/<job_id>/download"A machine-readable OpenAPI schema for the curated surface is available from Tech Takes on request (support@vonotix.com). Every endpoint above is read-only analytics over public market data — VNX executes no trades, holds no keys, and custodies no funds. Calculator output, not a recommendation.