Finance OS / API

List Transactions

GET /api/transactions
⚷ Bearer Token

История операций пользователя

Возвращает пагинированный список всех операций пользователя: депозиты, выводы, обмены, OTC-сделки, переводы между внутренними счетами, начисления (cashback, бонусы).

Query parameters

Name Type Required Description
page integer optional Номер страницы.
Default: 1
per_page integer optional Максимум 100.
Default: 20
filter[type] string optional Фильтр по типу: deposit, withdraw, exchange, otc, transfer, bonus.
filter[status] string optional pending, completed, failed, cancelled.
filter[currency] string optional Тикер валюты: USDT, BTC, RUB.
filter[date_from] string (ISO-8601) optional Начало периода (включительно).
filter[date_to] string (ISO-8601) optional Конец периода (включительно).
sort string optional Поля: created_at, amount, amount_rub. Префикс - — DESC.
Default: -created_at

Response

Responses

{
  "data": [
    {
      "id": "tx_5f8d7a3c-1234-4567-89ab-cdef01234567",
      "type": "deposit",
      "status": "completed",
      "amount": "100.000000",
      "currency": "USDT",
      "network": "TRC20",
      "amount_rub": "9750.00",
      "fee": "0.000000",
      "fee_currency": "USDT",
      "tx_hash": "0xabc123...",
      "from_address": "TXYZabcdef...",
      "to_address": "TYourDepositAddress...",
      "confirmations": 19,
      "required_confirmations": 1,
      "created_at": "2026-05-27T14:23:00Z",
      "completed_at": "2026-05-27T14:25:30Z",
      "description": null,
      "external_id": null,
      "links": {
        "explorer": "https://tronscan.org/#/transaction/0xabc...",
        "self": "https://fin-os.io/api/transactions/tx_5f8d..."
      }
    }
  ],
  "links": {
    "first": "https://fin-os.io/api/transactions?page=1",
    "last":  "https://fin-os.io/api/transactions?page=15",
    "prev":  null,
    "next":  "https://fin-os.io/api/transactions?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "to": 20,
    "per_page": 20,
    "total": 287,
    "last_page": 15
  }
}

Типы операций

Name Type Required Description
deposit optional Входящий депозит (крипто или СБП).
withdraw optional Исходящий вывод.
exchange optional Внутренний обмен (например, USDT → RUB).
otc optional OTC-сделка с другим пользователем.
transfer_in optional Входящий внутренний перевод (от другого пользователя Finance OS).
transfer_out optional Исходящий внутренний перевод.
trading_buy optional Покупка на бирже через подключённый API-ключ.
trading_sell optional Продажа на бирже.
bonus optional Начисление (cashback, referral, mining payout).
fee optional Списание комиссии.

Статусы

Name Type Required Description
pending optional Создана, обрабатывается. Для депозитов — ждём подтверждений в сети.
completed optional Финализирована, баланс изменён.
failed optional Не удалась — компенсация уже выполнена (если списали).
cancelled optional Отменена пользователем или системой.