REST API reference
Send X-API-Key and X-Secret-Key from your server, never public code. GET /api/bots?userEmail=YOUR_EMAIL lists your bots; GET /api/bots/{id} shows one. POST /api/bots/{id}/start moves money for a real bot. Limit: 120 requests/minute per key; revoke it from My account.
curl "https://app.dearmastrader.com/api/bots?userEmail=YOUR_EMAIL" \ -H "X-API-Key: YOUR_KEY" \ -H "X-Secret-Key: YOUR_SECRET"
| HTTP | URL | scope |
|---|---|---|
| GET | /api/bots?userEmail=YOUR_EMAIL | read |
| GET | /api/bots/{id} | read |
| GET | /api/bots/{id}/executions | read |
| GET | /api/bots/{id}/orders | read |
| GET | /api/bots/{id}/pnl | read |
| GET | /api/markets/{exchange}/symbols?type=spot"e=USDT | read |
| POST | /api/bots/validate | CanTrade |
| POST | /api/bots | CanTrade |
| PUT | /api/bots/{id} | CanTrade |
| POST | /api/bots/{id}/start | CanTrade |
| POST | /api/bots/{id}/stop?closePosition=false | CanTrade |
| GET | /api/backtest/limits | read |
| GET | /api/backtest/jobs | read |
| GET | /api/backtest/jobs/{id} | read |
| POST | /api/backtest/jobs | CanUseLab |
| DELETE | /api/backtest/jobs/{id} | CanUseLab |
POST /api/bots · Demo · Content-Type: application/json
{
"userEmail": "YOUR_EMAIL",
"name": "Demo",
"strategyType": "DCA_SPOT",
"exchange": "Binance",
"baseAsset": "BTC",
"quoteAsset": "USDT",
"investment": 100,
"leverage": 1,
"dcaTotalBudget": 100,
"dcaInitialOrderSize": 25,
"dcaMaxSafetyOrders": 2,
"dcaPriceScalePercent": 2,
"dcaVolumeScale": 1,
"dcaPriceStepMultiplier": 1,
"takeProfit": 2,
"stopLoss": 5,
"isDemo": true
}400 · BotPlanLimit401 · ApiKeyInvalid / AuthRequired403 · ApiKeyAddress / ApiKeyScope429 · ApiKeyRateLimit (120/min) / ApiKeyBacktestLimit (100/24h)