Список заказов

Метод возвращает только заказы аккаунта, связанного с API-ключом.

Параметры строки запроса

Параметр	Тип	По умолчанию	Описание
limit	integer	20	Размер страницы от 1 до 100.
cursor	string	—	Непрозрачный курсор из предыдущего next_cursor.

В подпись входит точная строка параметров вместе с ведущим ?. Не сортируйте и не кодируйте её повторно после подписания.

Ответ 200

{"items":[{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"energy_usable":false}],"next_cursor":"opaque-value"}

items отсортирован от новых к старым. На последней странице ключ next_cursor не приходит вовсе — сравнение с null конец списка не увидит, поэтому останавливайтесь, когда ключа нет. Поля внутри элемента ведут себя так же: у заказа выше нет ни rental_expires_at, ни failure, потому что этих значений пока нет.

Каждый элемент содержит полный заказ, включая status (created, executing, available, delivered, rental_finished, failed, rental_interrupted), energy_usable и rental_expires_at. Чтобы понять, с каких адресов уже можно отправлять транзакции, фильтруйте по energy_usable, а не по status == "delivered": в статусе available Energy уже доступна, и оплаченное время уже идёт, а у заказа с истёкшим окном Energy тратить уже нельзя, хотя статус ещё показывает delivered. Подробности: получение заказа.

Правила курсора

• Передавайте курсор без изменений.
• Не декодируйте и не конструируйте его самостоятельно.
• Курсор привязан к аккаунту и ресурсу.
• Курсор перестаёт работать через 24 часа после выдачи. Не сохраняйте его, чтобы продолжить обход на следующий день, — начинайте заново, без курсора.
• Некорректный, изменённый, просроченный или чужой курсор возвращает 400 с кодом pagination_cursor_invalid.