Tradva
Documentation/API Reference

API Reference

Complete reference documentation for the Tradva REST API. Build powerful integrations with our trading platform.

Base URL: api.tradva.com/v1
TLS 1.3 Required

On this page

AuthenticationRate LimitsEndpointsError HandlingWebhooks

Get API Keys

Generate API keys in your dashboard to start integrating.

Get Keys

Authentication

The Tradva API uses Bearer token authentication. Include your API key in the Authorization header of all requests.

Authorization: Bearer YOUR_API_KEY

Quick Start

const Tradva = require('@tradva/sdk');

const client = new Tradva({
  apiKey: process.env.TRADVA_API_KEY,
  environment: 'production'
});

// Create a new trading account
const account = await client.accounts.create({
  userId: 'user_123',
  type: 'challenge',
  balance: 100000,
  currency: 'USD'
});

console.log('Account created:', account.id);

Endpoints

Authentication

POST/auth/tokenGenerate access token
POST/auth/refreshRefresh access token
DELETE/auth/revokeRevoke access token

Accounts

GET/accountsList all accounts
POST/accountsCreate new account
GET/accounts/{id}Get account details
PATCH/accounts/{id}Update account
GET/accounts/{id}/balanceGet account balance

Trading

GET/ordersList all orders
POST/ordersPlace new order
GET/orders/{id}Get order details
DELETE/orders/{id}Cancel order
GET/positionsList open positions
POST/positions/{id}/closeClose position

Challenges

GET/challengesList all challenges
POST/challengesCreate new challenge
GET/challenges/{id}Get challenge details
GET/challenges/{id}/statsGet challenge statistics
POST/challenges/{id}/evaluateTrigger evaluation

Rate Limits

API requests are rate limited to ensure fair usage and platform stability.

Standard Tier
100 req/min
Enterprise Tier
10,000 req/min