The TronMax API V1 provides a simple and secure way to interact with the TronMax platform for purchasing and managing TRON Energy and Bandwidth.
\nThis API allows developers and services to:
\nCreate energy or bandwidth orders
\nTrack order status
\nCancel active orders
\nRetrieve user account information and available credit
\nAll requests are authenticated using an API key, and responses are returned in JSON format.
\nThe API is designed to be minimal, fast, and production-ready, making it easy to integrate into automated systems, trading bots, or backend services.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"10875168","collectionId":"2af35b04-9ec0-4e86-b33c-641474a68392","publishedId":"2sBXVcksnG","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-03T16:13:13.000Z"},"item":[{"name":"Orders","item":[{"name":"CreateOrder","id":"fbb7b7de-83a8-4e9b-85da-bcce41cc7a09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{apiKey}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"Fast\", \n \"resourceType\": \"Energy\",\n \"receiver\": [\n \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\",\n \"T9zrvJiJjZMnPwKwSEjejcbBpvXc3qhdxd\",\n \"TBLjhW2Fi8U2guV5maDC8MqTXtWVrdNjC5\",\n \"TDGSR64oU4QDpViKfdwawSiqwyqpUB6JUD\",\n \"TX74o6dWugAgdaMv8M39QP9YL5QRgfj32t\",\n \"TDqGdq76PDHrEXfEPMmNa2ayc7E4PKzfS1\",\n \"TEY7pBUV3HpGgie5N7Zu92hbZDfUwMKbK1\",\n \"TN8Qr4M1Drm7byHZAf93yE6HwH4acy8M3D\",\n \"TLEtwNCzJM4d32z9vRsX4WS91WUpRXPsfP\",\n \"TXF6UZpnZ4PvPJhYHkwR17UGKBTYmYSkm3\",\n \"TQg3vYxLWwT8mCvbYcjRjfuXg3hshA8zcW\",\n \"TLZ4gv7jzyowyvmjEmWivGTQDu22RPt7XL\",\n \"TGMayYkhjRVwbYFFdadpBucftYrEM6JNCs\",\n \"TG6S8iGR4D5rvpp4rQDn4gg8qA1aW7stHA\",\n \"TCuywKCAGbLqpjx3X9vun277r59b4kbVWQ\",\n \"TBzjkv194MiGvvmuDTYxpRun6jamQHaE21\",\n \"TBz1qnfnj7W7HnrCuC2eaA7E1euR32MwNW\"\n ],\n \"resourceAmount\": 65000,\n \"duration\": \"15m\"\n\n}\n","options":{"raw":{"language":"json"}}},"url":"{{apiUrl}}/v1/order/Create","description":"Creates a new Energy or Bandwidth order.
\nThis endpoint supports bulk orders. When multiple wallet addresses are provided in the receiver field, the system creates one order per receiver (maximum 20 receivers per request).
Order behavior depends on the selected type:
Manual orders require a price and use it for pricing and matching.
Fast orders do not use price for calculation. If price is provided, it is validated only.
All field values such as type and resourceType are case-insensitive.
type (string, required)
Order type. Supported values: Fast, Manual.
Case-insensitive.
resourceType (string, required)
Resource type. Supported values: Energy, Bandwidth.
Case-insensitive.
receiver (string[], required)
List of TRON wallet addresses (bulk order).
Min: 1 wallet
Max: 20 wallets
One order will be created per receiver.
\nresourceAmount (number, required)
Requested resource amount.
\n Unit depends on resourceType.
duration (string, required)
Order duration. Supported formats:
\n\"15m\" = 15 minutes
\"1h\" = 1 hour
\"1d\" = 1 day
price (number, conditional)
Required when type = \"Manual\"
Optional when type = \"Fast\"
If provided in Fast mode, it must be greater than 40 and is used for validation only (not used in pricing calculation).
\noptions (object, optional) Optional order settings.
options.allow_partial (boolean, optional)
If true, the system may partially fulfill the order if full amount is not available.
options.partial_min (number, conditional)
Minimum acceptable amount for partial fulfillment.
\n Required when allow_partial = true.
This response confirms that the order request was accepted and orders were created successfully.
\nIf the request contains multiple wallets in receiver, the API creates one order per receiver and returns them inside the orders array.Field Details
success (boolean)
Indicates whether the request was successful.
\ndata.count (number)
Number of orders created in this request.
\n In bulk mode, this is equal to the number of items in receiver.
data.orders (array)
List of created orders. Each item represents one receiver/order.
\norders[] object fieldsorderId (string)
Unique ID of the created order (case-sensitive).
\nUse this value for order status tracking and cancellation.
\nreceiver (string)
The TRON wallet address that will receive the delegated resource.
\ntype (string)
Order type (e.g., Fast, Manual).
Input is case-insensitive; response is normalized.
\nresourceType (string)
Resource type of the order (energy or bandwidth).
resourceAmount (number)
Requested resource amount for this order.
\nprice (number)
Final price used for this order.
Fast mode note: the returned price may represent the calculated market price, not the input value.
paidAmount (number)
Amount paid for this order, in TRX.
\nstatus (string)
Current order status at creation time. Usually:
\nprocessing (order queued and being fulfilled)createdAt (number)
Creation timestamp in milliseconds (Unix epoch).
\nCancels an existing order using its orderId.
The order must belong to the authenticated API user and must be in a cancellable state (for example, processing).
Completed or already settled orders cannot be canceled.
\nThe orderId value is case-sensitive and must be provided exactly as returned by the Create Order API.
success (boolean)
Indicates whether the cancellation request was successful.
\ndata.status (string)
Final status of the order after cancellation.
\n Expected value: cancelled.
data.frozen (number)
Amount of the order that was already fulfilled at the time of cancellation.
0 means no resource was delegated before canceling.
(If greater than 0, it means the order was partially filled before cancellation.)
data.refunded (number)
Amount refunded back to the user’s account credit after cancellation.
\nThe value represents the refundable amount based on the order state at the time of cancel.
\ndata.cancelledAt (number)
Cancellation timestamp in milliseconds (Unix epoch).
\nThis response returns the current status and execution details of a specific order.
\nIt provides information about:
\nOrder progress
\nFinal execution status
\nDelegated resource transactions (on-chain)
\norderId (string)
Unique identifier of the order.
\nThis value is case-sensitive.
\nreceiver (string)
TRON wallet address that received the delegated resource.
\ntype (string)
Order type (Fast, Manual, etc.).
Case-insensitive on input, normalized in response.
\nresourceType (string)
Resource type of the order (energy or bandwidth).
resourceAmount (number)
Requested amount of the resource.
\nprice (number)
Final execution price of the order.
\nFor Fast orders, this value represents the actual market price, not the input price.
\npaidAmount (number)
Total amount paid for this order, in TRX.
\nfilled (number)
Percentage of the order that has been successfully fulfilled.
100 means the order is fully completed.
status (string)
Current order status. Possible values include:
\nprocessing
completed
cancelled
createdAt (number)
Order creation timestamp in milliseconds (Unix epoch).
\nThe transactions array contains on-chain delegation records related to this order.
Each transaction includes:
\nfrozenAmount (number)
Amount of resource delegated (in SUN).
\ntxId (string)
Blockchain transaction ID of the delegation.
\nsettledAt (number)
Timestamp when the delegation was successfully settled (milliseconds).
\nAn order may contain multiple transactions if it was fulfilled using multiple resource pools.
\nIf transactions is empty, the order has not yet been fulfilled.
For partially filled orders, filled may be less than 100.
Once status is completed, no further changes will occur to the order.
Retrieves basic account information for the authenticated API user.
\nThis endpoint returns:
\nThe user’s wallet address
\nThe current available credit balance
\nAuthentication is handled via the x-api-key header inherited from the collection.