API Reference
REST API endpoints for the Vezta trading platform
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
- Authentication — Wallet-based auth with nonce, verify, and refresh endpoints
- Markets — Browse, search, and filter prediction markets
- Events — Event groups and categories
- Trading — Order placement, management, and execution
- Portfolio — Positions, balances, and PnL tracking
- Leaderboard — Top trader rankings
- Copy Trade — Copy trading subscriptions
- Rewards — Points, missions, and challenges
- Notifications — Alerts and device tokens
- Monitor — AI signals and news
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.