Finance OS / API

Dashboard Stats

GET /api/dashboard/stats
⚷ Bearer Token

Агрегированная статистика пользователя

Возвращает компактный срез ключевых метрик для дашборда: total balance, P&L за период, число транзакций, открытые позиции, активные ордера, статус mining-выплат.

Query parameters

Name Type Required Description
period string optional Окно для P&L и счётчиков: 1d, 7d, 30d, 90d, ytd, all.
Default: 30d
currency string optional Валюта отображения total/P&L: RUB, USD, USDT.
Default: RUB

Response

Responses

{
  "data": {
    "totals": {
      "balance": "394745.80",
      "currency": "RUB",
      "as_of": "2026-05-27T14:23:00Z"
    },
    "pnl": {
      "period": "30d",
      "absolute": "+12450.30",
      "percent": "+3.25",
      "trend": "up"
    },
    "counters": {
      "transactions_30d": 87,
      "open_orders": 4,
      "active_otc_deals": 1,
      "mining_workers_online": 12
    },
    "balances_top": [
      { "currency": "USDT", "amount": "1350.45", "rub_equivalent": "131625.50" },
      { "currency": "BTC",  "amount": "0.0543",   "rub_equivalent": "248120.30" },
      { "currency": "RUB",  "amount": "15000.00", "rub_equivalent": "15000.00" }
    ],
    "recent_activity": [
      { "type": "deposit",  "amount": "100.00", "currency": "USDT", "at": "2026-05-27T13:10:00Z" },
      { "type": "withdraw", "amount": "50.00",  "currency": "USDT", "at": "2026-05-27T11:45:00Z" }
    ],
    "alerts": [
      { "type": "low_balance", "message": "RUB balance below 20,000 — consider topping up." }
    ]
  }
}
✦
Кэширование
Stats кэшируются на 60 секунд per-user. Если нужны свежие данные сразу после операции — используйте конкретные endpoints (/wallet/balance, /transactions).