{
  "info": {
    "_postman_id": "2af35b04-9ec0-4e86-b33c-641474a68392",
    "name": "TronMax Official API V1",
    "description": "# ⚡ TronMax Official API V1\n\nOfficial Postman Collection for high-throughput automated TRON Energy & Bandwidth delegation.\n\n🔗 **Primary Interactive Documentation:**  \nVisit **[https://tronmax.io/api-docs](https://tronmax.io/api-docs)** for interactive API playground, real-time rates discovery, and multi-language code snippets (Python, Node.js, cURL, Go, PHP, C#).\n\n---\n\n### 🔑 Authentication & Headers\n- **Prepaid Orders (`/v1/*`)**: Header `x-api-key: YOUR_API_KEY` is required.\n- **Public Settings & Rates (`/setting/*`)**: No authentication required.\n\n### 🌐 Base URL\n`https://api.tronmax.io`",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "apiKey",
      "value": "YOUR_API_KEY",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "1. API Key Orders (V1)",
      "item": [
        {
          "name": "Create Order (Fast / Manual)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{apiKey}}",
                "type": "text",
                "description": "Your API Key from TronMax Buyers Portal"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"Fast\",\n  \"resourceType\": \"Energy\",\n  \"receiver\": [\n    \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\"\n  ],\n  \"resourceAmount\": 65000,\n  \"duration\": \"1h\"\n}"
            },
            "url": {
              "raw": "https://api.tronmax.io/v1/order/create",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "v1",
                "order",
                "create"
              ]
            },
            "description": "Creates a new Fast or Manual order for Energy or Bandwidth. Supports bulk delegation for up to 20 TRON recipient addresses in a single call. For Manual orders, specify type='Manual', price (in SUN, dynamic minimum floor by duration fetched via GET /setting/ui ratesByDuration), and options: { allow_partial: true, partial_min: 20000, bulk_order: false }."
          },
          "response": [
            {
              "name": "200 OK - Fast Order Created",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"count\": 1,\n    \"orders\": [\n      {\n        \"orderId\": \"6959016b9b11c5d92b78b48b\",\n        \"receiver\": \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\",\n        \"type\": \"Fast\",\n        \"resourceType\": \"energy\",\n        \"resourceAmount\": 65000,\n        \"price\": 65,\n        \"paidAmount\": 4.225,\n        \"status\": \"processing\",\n        \"createdAt\": 1767440747372\n      }\n    ]\n  }\n}"
            },
            {
              "name": "200 OK - Manual Order Created",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"count\": 1,\n    \"orders\": [\n      {\n        \"orderId\": \"6959016b9b11c5d92b78b48b\",\n        \"receiver\": \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\",\n        \"type\": \"Manual\",\n        \"resourceType\": \"energy\",\n        \"resourceAmount\": 200000,\n        \"price\": 65,\n        \"paidAmount\": 13.0,\n        \"status\": \"open\",\n        \"options\": {\n          \"allow_partial\": true,\n          \"partial_min\": 20000,\n          \"bulk_order\": false\n        },\n        \"createdAt\": 1767440747372\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Get Order Status & TxIDs",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{apiKey}}",
                "type": "text",
                "description": "Your API Key from TronMax Buyers Portal"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"orderId\": \"6959016b9b11c5d92b78b48b\"\n}"
            },
            "url": {
              "raw": "https://api.tronmax.io/v1/order/status",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "v1",
                "order",
                "status"
              ]
            },
            "description": "Returns execution status, fill percentage, and settled blockchain transaction IDs (TxIDs). Requires orderId in the JSON request body."
          },
          "response": [
            {
              "name": "200 OK - Order Status Completed",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"orderId\": \"6959016b9b11c5d92b78b48b\",\n    \"receiver\": \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\",\n    \"type\": \"Fast\",\n    \"resourceType\": \"energy\",\n    \"resourceAmount\": 65000,\n    \"price\": 65,\n    \"paidAmount\": 4.225,\n    \"filled\": 100,\n    \"status\": \"completed\",\n    \"createdAt\": 1767440747372,\n    \"transactions\": [\n      {\n        \"frozenAmount\": 65000,\n        \"txId\": \"e39fd7a68e8334460f9976371cf79c53648a8dc2287cf38ac5a5254134beee91\",\n        \"settledAt\": 1767440751200\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Cancel Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{apiKey}}",
                "type": "text",
                "description": "Your API Key from TronMax Buyers Portal"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"orderId\": \"6959016b9b11c5d92b78b48b\"\n}"
            },
            "url": {
              "raw": "https://api.tronmax.io/v1/order/cancel",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "v1",
                "order",
                "cancel"
              ]
            },
            "description": "Cancels an active order. Remaining unfilled funds are immediately and atomically refunded back to your buyer credit balance."
          },
          "response": [
            {
              "name": "200 OK - Order Cancelled",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"orderId\": \"6959016b9b11c5d92b78b48b\",\n    \"status\": \"canceled\",\n    \"refundedAmount\": 4.225,\n    \"refundedAt\": 1767440789000\n  }\n}"
            }
          ]
        },
        {
          "name": "Get User Info & Deposit Address",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "x-api-key",
                "value": "{{apiKey}}",
                "type": "text",
                "description": "Your API Key from TronMax Buyers Portal"
              }
            ],
            "url": {
              "raw": "https://api.tronmax.io/v1/user/info",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "v1",
                "user",
                "info"
              ]
            },
            "description": "Returns account details for the authenticated API key: linked TRON wallet address, available buyer credit balance (in TRX), and your dedicated on-chain deposit wallet address."
          },
          "response": [
            {
              "name": "200 OK - Account Info & Deposit Wallet",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"wallet\": \"THzxp2J3D9WhgSyC3t5yYSdwEjiv6Eg3as\",\n    \"credit\": 15420.5,\n    \"depositWalletAddress\": \"TJY5PkW8mFh7qUvWz8tLNm6B6X6uJkP9qR\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "2. Platform Settings & Rates",
      "item": [
        {
          "name": "Get UI Settings & Market Rates",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.tronmax.io/setting/ui",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "setting",
                "ui"
              ]
            },
            "description": "Public rate discovery endpoint. Returns DApp contract address, rates by lock duration, fast rates, fast charge configuration, daily recovery totals, and ready delegatable resources."
          },
          "response": [
            {
              "name": "200 OK - UI Settings & Rates",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"data\": {\n    \"DappAddress\": \"TXYZ123456789DappAddressOnTRON\",\n    \"readyResource\": {\n      \"energy\": 85000000,\n      \"bandwidth\": 4500000\n    },\n    \"fastSellRate\": { \"energy\": 100, \"bandwidth\": 700 },\n    \"ratesByDuration\": [\n      { \"exactDurationSeconds\": 3600, \"rate\": 65 },\n      { \"exactDurationSeconds\": 86400, \"rate\": 110 }\n    ],\n    \"ratesByDurationFast\": [\n      { \"exactDurationSeconds\": 3600, \"rate\": 70 },\n      { \"exactDurationSeconds\": 86400, \"rate\": 120 }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Get Available Resources Liquidity",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://api.tronmax.io/setting/resource-available",
              "protocol": "https",
              "host": [
                "api",
                "tronmax",
                "io"
              ],
              "path": [
                "setting",
                "resource-available"
              ]
            },
            "description": "Returns live delegatable capacity across sellers grouped by unit rate (SUN). Provides immediate orderbook depth for energy and bandwidth."
          },
          "response": [
            {
              "name": "200 OK - Liquidity Depth",
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"energy\": [\n    { \"rate\": 60, \"available\": 2500000 },\n    { \"rate\": 65, \"available\": 12000000 },\n    { \"rate\": 70, \"available\": 45000000 }\n  ],\n  \"bandwidth\": [\n    { \"rate\": 500, \"available\": 800000 },\n    { \"rate\": 600, \"available\": 2400000 }\n  ]\n}"
            }
          ]
        }
      ]
    }
  ]
}