REST API (Pro+)
Programmatic access to your Tradevanish account. Manage accounts, proxies, trades, and listeners via API.
Authentication
Generate an API key in Profile > REST API > Generate Key.
curl -H "Authorization: Bearer pc_live_YOUR_API_KEY" \
https://www.tradevanish.com/api/accounts
API keys are hashed with SHA-256 and stored securely. The raw key is shown only once on creation.
Endpoints
Accounts
| Method | Endpoint | Description |
|---|
| GET | /api/accounts | List all connected accounts |
| POST | /api/accounts | Connect a new account |
| DELETE | /api/accounts/:id | Disconnect an account |
| PATCH | /api/accounts/:id/pause | Pause/resume a follower |
Broker Stats
| Method | Endpoint | Description |
|---|
| POST | /api/brokers/stats | Get live balance, equity, win rate |
| POST | /api/brokers/topstepx/auth | Authenticate with TopStepX |
| POST | /api/brokers/tradovate/auth | Get Tradovate OAuth URL |
Proxies
| Method | Endpoint | Description |
|---|
| GET | /api/proxies | List all proxy assignments |
| POST | /api/proxies/:accountId/rotate | Rotate an account's IP |
| POST | /api/proxies/:accountId/test | Test proxy health |
| GET | /api/proxies/providers | List available providers |
Listeners
| Method | Endpoint | Description |
|---|
| POST | /api/listeners/start | Start the master listener |
| POST | /api/listeners/stop | Stop the master listener |
| GET | /api/listeners/status | Get listener state and stats |
Settings
| Method | Endpoint | Description |
|---|
| GET | /api/settings/risk | Get risk rule configuration |
| PUT | /api/settings/risk | Update risk rules |
Signals
| Method | Endpoint | Description |
|---|
| POST | /api/signals/:signalKey | Receive a trading signal (no auth needed) |
| POST | /api/signals/keys | Generate a new signal key |
| GET | /api/signals/keys | List active signal keys |
| GET | /api/signals/history | View signal execution history |
Rate Limits
API requests are limited to 60 requests per minute per API key.
Error Responses
{
"error": "plan_required",
"message": "This feature requires Pro+. Current plan: basic",
"upgrade_url": "/api/billing/plans"
}