Listar pedidos

El endpoint devuelve solo los pedidos de la cuenta asociada a la credencial de API.

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
limit	entero	20	Tamaño de página, de 1 a 100.
cursor	cadena	—	Valor opaco del next_cursor anterior.

La firma incluye la cadena de consulta exacta con su ? inicial. No la reordenes ni la vuelvas a codificar después de firmar.

Respuesta 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"}

Los items van del más reciente al más antiguo. En la última página next_cursor se omite entero de la respuesta en vez de llegar como null, así que detén la paginación cuando la clave no esté: comprobar un null explícito no detecta nunca el final de la lista. Los campos de cada elemento se comportan igual: el pedido de arriba no trae rental_expires_at ni failure porque todavía no tiene ninguno de los dos valores.

Cada elemento trae la forma completa de un pedido, incluidos status (created, executing, available, delivered, rental_finished, failed, rental_interrupted), energy_usable y rental_expires_at. Para saber qué direcciones pueden gastar Energy ahora mismo, filtra por energy_usable y no por status == "delivered". Un pedido en available ya es utilizable y su ventana pagada ya está corriendo. Un pedido cuya ventana ha terminado ya no lo es, aunque su estado siga leyéndose como delivered. Más detalles en consultar un pedido.

Reglas del cursor

• Pasa el cursor sin cambiarlo.
• No lo descodifiques ni lo construyas tú.
• Un cursor está ligado a su cuenta y a su recurso.
• Un cursor deja de funcionar 24 horas después de emitirse. No lo guardes para retomar el recorrido al día siguiente; empieza de nuevo sin cursor.
• Un cursor no válido, modificado, caducado o de otra cuenta devuelve 400 con pagination_cursor_invalid.