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

Метод для поиска и постраничного получения транзакций с гибкой фильтрацией. Авторизация через 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 (UUID)	f47ac10b-58cc-4372-a567-0e02b2c3d479
order_by	Поле сортировки (started/updated)	started
limit	Размер страницы (по умолчанию 100)	50
cursor	Курсор из предыдущего ответа для получения следующей страницы	(см. Формат ответа)

Пример

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' \
  --header 'x-api-key: ВАШ_КЛЮЧ'

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

{
  "data": [
    {
      "id": "c033ceaa-3726-4479-8be3-c9af8a0b2336",
      "txid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "payment",
      "status": "charged",
      "amount": "10000",
      "currency": "USDT",
      "env": "prod",
      "started": "2025-09-05T13:57:56Z",
      "finished": "2025-09-05T13:58:10Z",
      "route": null
    }
  ],
  "cursor": {
    "cursor_field": "started",
    "cursor_value": "2025-09-05T13:58:10Z"
  }
}

Примечания

• Результаты обёрнуты в data; cursor содержит позицию для следующей страницы.
• unspecified_id охватывает разные типы идентификаторов.
• Сужайте выборку временными интервалами для производительности.
• Пагинация курсорная (по умолчанию limit 100); передавайте cursor из предыдущего ответа для получения следующей страницы.