List Orders

GET 
/orders

List your Energy and Bandwidth orders, newest first. Results are paginated with page/page_size.

Filters:

• status — return only orders in this status (PENDING, COMPLETED, FAILED, …). Case-insensitive.
• receiver_address — return only orders delivered to exactly this address. Pass the full 34-character TRON address; a partial address matches nothing.

Request

Responses

200

A page of orders, newest first.

401

The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.

403

The account is blocked (plain-string detail: Account is blocked), or ip_not_allowed — the request's source IP is outside this key's IP allowlist.

422

A query parameter is out of range (e.g. page_size above 100) — detail is an array of field errors.

429

Rate limit exceeded — more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.

Response Headers

Retry-After

Seconds until the rate-limit window resets.