Architecture
Controller Inventory
Inventory of the NestJS controllers grouped by domain (50+ REST controllers plus internal webhook/metrics endpoints)
This page lists every controller in the Vezta backend, grouped by functional domain. Each entry shows the controller name, route prefix, and a brief description of its purpose.
| Controller | Prefix | Purpose |
|---|
AuthController | /api/v1/auth | Wallet nonce/verify, JWT refresh, Google OAuth, access key activation, logout |
TelegramBotController | /api/v1/telegram-bot | Interactive trading bot: webhook, account linking |
UserController | /api/v1/user | Profile, email verification, preferences, API keys, connected wallets, onboarding |
KycController | /api/v1/kyc | KYC verification: document upload, selfie, DFlow identity checks |
PushNotificationController | /api/v1/push | Firebase FCM device token registration |
WaitlistController | /api/v1/waitlist | Waitlist signup, status check, tweet verification, stats |
| Controller | Prefix | Purpose |
|---|
MarketController | GET /api/v1/markets | Browse, search, detail, charts, order books, comments, holders, activity, crypto prices |
TrendingTabsController | GET /api/v1/trending-tabs | Dynamically-sourced trending market tabs |
EventsController | GET /api/v1/events | Event groups, categories, multi-market event charts |
MatchController | GET /api/v1/matches | Sports and esports match listings, leagues |
CalendarController | GET /api/v1/calendar | Calendar events with associated prediction markets |
SearchController | GET /api/v1/search | Unified search across markets, events, and traders |
MarketIntelController | GET /api/v1/market-intel | Polymarket top events and activity |
AnalyticsController | GET /api/v1/analytics | Protocol overview, per-protocol breakdown, multi-chart data |
ArbitrageMatchController | GET /api/v1/markets/arbitrage | Cross-platform arbitrage groups (Polymarket ↔ Kalshi) |
FeedController | /api/v1 | Aggregated news feed |
AppVersionController | GET /api/v1/app | Version check by platform |
SportsStatsController | /api/v1 | ESPN live scores, standings, prematch/resolve |
StandingsController | /api/v1/standings | League standings snapshots |
WeatherController | /api/v1/weather | Weather / temperature markets |
ContestController | /api/v1/contests/wc-oracle | World Cup oracle contest entries/standings |
| Controller | Prefix | Purpose |
|---|
TradingController | /api/v1/orders | Order placement, management, cancel, TP/SL, DFlow confirmation |
DflowProxyController | GET /api/v1/dflow | DFlow on-chain order proxy: order creation, status, market init |
MergeSplitController | POST /api/v1/merge-split | Polymarket conditional token merge and split |
SniperController | /api/v1/sniper/orders | Sniper order CRUD: create, list, update, cancel |
CounterTradeController | /api/v1/counter-trade | Counter trade rule configs: create, list, update, delete |
ArbitrageController | GET /api/v1/arbitrage | Cross-venue arbitrage opportunity listing |
TradingRebatesController | /api/v1/trading | Maker-rebate / LP-reward stats and claims |
ComboController | /api/v1/combo | Multi-leg combo / parlay trade placement and status |
ComboCatalogController | /api/v1/combos | Combo catalog listings and eligibility |
| Controller | Prefix | Purpose |
|---|
PortfolioController | /api/v1/portfolio | Positions, orders, watchlist, PnL chart, calendar, resolved market claims, TP/SL |
AccountController | /api/v1/account | Deposits, withdrawals, fiat on-ramp, transactions, CSV export |
SubWalletController | /api/v1/wallet | Sub-wallet management: create, fund, withdraw, approve tokens, export key |
| Controller | Prefix | Purpose |
|---|
LeaderboardController | /api/v1/leaderboard | Global rankings, biggest wins, Kalshi-only, trader profiles |
TrackerController | /api/v1/tracker | Wallet tracker: feed, add/remove wallets, suggested wallets, top-100, bubble map |
WalletListController | /api/v1/wallet-lists | Custom address lists: create, add entries, preview, trades |
CopyTradeController | /api/v1/copy-trade | Copy trading: subscribe, manage subscriptions, history, performance |
ActivityController | /api/v1/activity | User activity feed |
| Controller | Prefix | Purpose |
|---|
MonitorController | /api/v1/monitor | Market signals, system stats, DB health |
InsiderSignalsController | /api/v1/insider-signals | Insider signal feed, user feedback submission |
AiPredictionsController | /api/v1/ai-predictions | AI prediction listing, stats, individual prediction detail |
AlertsController | /api/v1/alerts | Price alert CRUD: create, list, update, delete |
| Controller | Prefix | Purpose |
|---|
ShareCardController | /api/v1/share-card | PnL cards, market cards, background management |
PublicShareCardController | /api/v1/share-card/public | Published card retrieval and metadata |
OgPnlController | /api/v1/og | PnL image and animated MP4 generation |
BackgroundController | /api/v1/share-card/background | Share card background presets, upload, presign, finalize |
RewardsController | /api/v1/rewards | Points dashboard, missions, challenges, referrals, access keys, leaderboard |
NotificationController | /api/v1/notifications | In-app notifications: list, mark read, dismiss |
| Controller | Prefix | Purpose |
|---|
AgentController | /api/v1/agent | In-app AI chat: SSE streaming, conversations, models, preferences, feedback, transcribe |
ResearchController | /api/v1/research | Structured probability-estimation research pipeline |
| Controller | Prefix | Purpose |
|---|
AdminController | /api/v1/admin | Dashboard, user management, access keys, positions, analytics, waitlist, revenue |
HealthController | GET /api/v1/health | Service health check with runtime diagnostics |
HelpController | GET /api/v1/help | FAQ and help content |
TelemetryController | POST /api/v1/telemetry | Frontend telemetry ingestion (web vitals, FPS, errors) |
MetricsController | GET /metrics | Prometheus metrics scrape endpoint |
AlchemyWebhookController | POST /api/v1/webhooks/alchemy | Alchemy address-activity webhook (deposit detection) |
