API Reference

The Vezta API is a RESTful API built with NestJS and Fastify. All endpoints are prefixed with /api/v1/.

Base URL

• Production: https://backend.vezta.io
• Local Development: http://localhost:3001

Authentication

Most endpoints require a JWT access token in the Authorization header:

Authorization: Bearer <access_token>

Public endpoints (marked with @Public()) do not require authentication. See the Authentication section for the full wallet-based auth flow.

Response Format

All successful responses return JSON. All error responses follow a standardized format:

{
  "statusCode": 400,
  "code": "VALIDATION_ERROR",
  "message": "Description of what went wrong"
}

See Error Codes for the full list.

API Sections

Auth & Access

• Authentication — Wallet-based auth, Google OAuth, JWT lifecycle
• User — Profile, email verification, preferences, API keys, connected wallets
• KYC — Identity verification with document upload and selfie verification
• Push — Device token registration for push notifications
• Waitlist — Signup, status tracking, referral stats

Market Data

• Markets — Browse, search, filter, charts, order books, comments, activity
• Events — Event groups and categories with multi-market data
• Calendar — Calendar events with associated prediction markets
• Search — Unified search across markets, events, and traders
• Analytics — Protocol overview and per-protocol breakdown
• Feed — Aggregated news and market-related content
• App — Application version check by platform

Trading

• Trading — Order placement, management, cancel, TP/SL
• DFlow — On-chain order flow with DFlow integration
• Merge/Split — Polymarket conditional token merge and split operations
• Sniper — Auto-executing orders on new market listings
• Counter Trade — Automated opposite-side trading rules
• Arbitrage — Cross-venue arbitrage opportunity scanning
• Arbitrage Match — Cross-platform arbitrage groups (Polymarket ↔ Kalshi)

Portfolio & Account

• Portfolio — Positions, orders, watchlist, PnL, chart data
• Account — Deposits, withdrawals, transactions, fiat on-ramp
• Wallet — Sub-wallet creation, funding, withdrawals, token approvals

Social & Tracking

• Leaderboard — Global rankings, biggest wins, trader profiles
• Tracker — Follow wallets, monitor positions and trades in real time
• Wallet Lists — Custom address lists, previews, aggregated trades
• Copy Trade — Subscribe, manage, view performance history
• Activity — User activity feed

Signals & Monitoring

• Monitor — AI-powered market signals, system health
• AI Predictions — Model-generated predictions with accuracy stats
• Insider Signals — Insider trading signal feed and feedback
• Alerts — Market price alert management

Content & Rewards

• Share Card — PnL cards, market cards, background management
• Share Card (Public) — Published card retrieval
• Rewards — Points, missions, challenges, referral tree
• Notifications — In-app notification management

Admin & Utility

• Admin — Dashboard, user/access key management, analytics, revenue
• Health — Service health check and runtime diagnostics
• Telegram — Bot webhook receiver and account linking
• Help — FAQ and help content

OpenAPI Spec

The full OpenAPI 3.0 specification is available at /docs-json on the running backend server and is used to auto-generate TypeScript clients.