Developer documentation

API workspace
https://api.rentron.xyz/v1
OpenAPI schema

List orders

// GET

Production API

List orders

Read orders from newest to oldest with opaque cursor pagination.

GET /v1/energy/orders?limit=20&cursor=...
On this page

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":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"failure":null}],"next_cursor":"opaque-value"}

items are ordered newest first. next_cursor: null means there are no more pages.

Cursor rules

  • Pass the cursor unchanged.
  • Never decode or construct it yourself.
  • A cursor is bound to its account and resource.
  • An invalid, modified, or foreign cursor returns 400 with pagination_cursor_invalid.