Список транзакций

Метод для поиска и постраничного получения транзакций с гибкой фильтрацией. Авторизация через API-ключ.

Запрос

GET /api/v1/transactions?query_params
Заголовок: x-api-key: <api_key>

Параметры фильтрации

Параметр	Описание	Пример
unspecified_id	Поиск по любому идентификатору	10077001
started_to	Старт до времени (ISO)	2025-09-01T10:45:14Z
started_from	Старт после времени (ISO)	2025-09-01T10:45:14Z
updated_to	Обновление до времени	2025-09-01T11:45:14Z
updated_from	Обновление после времени	2025-09-01T11:45:14Z
type	Тип транзакции	payment
status	Статус	charged
env	Среда	prod
amount_to	Сумма <=	10000
amount_from	Сумма >=	10000
txid	Внешний id	98817018
order_by	Поле сортировки (started/updated)	started
limit	Размер страницы (по умолчанию 100)	50
page	Номер страницы (1+)	2

Пример

curl --location 'https://app.heth.me/api/v1/transactions?started_from=2025-09-01T10:45:14Z&type=payment&status=charged&order_by=started&limit=30&page=2' \
  --header 'x-api-key: ВАШ_КЛЮЧ'

Формат ответа

[
  {
    "id": "c033ceaa-3726-4479-8be3-c9af8a0b2336",
    "txid": "10077001",
    "type": "payment",
    "status": "charged",
    "amount": 10000,
    "currency": "USDT",
    "env": "prod",
    "started": "2025-09-05T13:57:56Z",
    "finished": "2025-09-05T13:58:10Z",
    "route": null
  }
]

Примечания

• unspecified_id охватывает разные типы идентификаторов.
• Сужайте выборку временными интервалами для производительности.
• По умолчанию: limit=100, page=1.
• Используйте order_by вместе с пагинацией для детерминированного обхода.