List orders

The endpoint returns only orders for the account associated with the API credential.

Query parameters

Parameter	Type	Default	Description
limit	integer	20	Page size from 1 to 100.
cursor	string	—	Opaque value from the previous next_cursor.

The signature includes the exact query string with its leading ?. Do not reorder or re-encode it after signing.

Response 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 are ordered newest first. On the last page next_cursor is left out of the response entirely rather than sent as null, so stop when the key is missing — a check for an explicit null will not see the end of the list. Fields inside an item behave the same way: the order above has no rental_expires_at and no failure key because it has neither value yet.

Each item carries the full order shape, including status (created, executing, available, delivered, rental_finished, failed, rental_interrupted), energy_usable, and rental_expires_at. To decide which addresses can spend Energy right now, filter on energy_usable, not on status == "delivered": an available order is already usable and its paid window is already running, and an order whose window has ended is no longer usable while its status still reads delivered. See get an order.

Cursor rules

• Pass the cursor unchanged.
• Never decode or construct it yourself.
• A cursor is bound to its account and resource.
• A cursor stops working 24 hours after it was issued. Do not store one to resume a walk the next day; start again without a cursor.
• An invalid, modified, expired, or foreign cursor returns 400 with pagination_cursor_invalid.