{"info":{"_postman_id":"e32a1ddd-eeff-41e7-9304-96046f5f6141","name":"re:Fee API Documentation (EN)","description":"<html><head></head><body><p>If you are building your own crypto service, bot, or managing a large number of addresses, automation becomes a key factor. For these purposes, we have developed an <strong>API integration with</strong> <a href=\"https://t.me/re_fee_bot?start=ADV_qGqGw9P\"><b>re:Fee</b></a> — connect and manage wallet energy through simple and reliable requests.</p>\n<h3 id=\"🔧-what-does-the-api-offer\">🔧 <strong>What does the API offer?</strong></h3>\n<p>With our API, you can:</p>\n<ul>\n<li><p>📤 Automatically top up energy on addresses;</p>\n</li>\n<li><p>🔄 Enable the “Always Charged” mode;</p>\n</li>\n<li><p>♾️ Set up auto-purchasing of energy;</p>\n</li>\n<li><p>📊 Monitor energy balance in real time.</p>\n</li>\n</ul>\n<p>This solution is ideal for:</p>\n<ul>\n<li><p>Crypto bots with high transactional activity;</p>\n</li>\n<li><p>DApp platforms with a large user base;</p>\n</li>\n<li><p>Services where uninterrupted operation is critical.</p>\n</li>\n</ul>\n<h3 id=\"🚀-why-its-convenient\">🚀 <strong>Why it’s convenient:</strong></h3>\n<ul>\n<li><p>Easy API connection;</p>\n</li>\n<li><p>High stability and fast performance;</p>\n</li>\n<li><p>Scalable solution for projects of any size;</p>\n</li>\n<li><p>Support and assistance from our team during integration.</p>\n</li>\n</ul>\n<p>🔑 The bot will provide you with your personal Token. To obtain it, please follow the <a href=\"https://t.me/re_fee_bot\"><b>link</b></a>. Do not share the token with third parties.</p>\n<p>📩 Have questions or need help connecting? Contact us at: <a href=\"https://t.me/re_fee_manager\">@re_fee_manager</a></p>\n<p>🛠 You can test the API with your own data in Swagger here: <a href=\"https://api.refee.bot/docs\">https://api.refee.bot/docs</a></p>\n<p>🌐 Base URL for requests: <a href=\"https://api.refee.bot/docs\">https://api.refee.bot</a></p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"45996988","collectionId":"e32a1ddd-eeff-41e7-9304-96046f5f6141","publishedId":"2sB2xBBp4S","public":true,"customColor":{"top-bar":"010101","right-sidebar":"303030","highlight":"e1163a"},"publishDate":"2025-06-19T14:37:35.000Z"},"item":[{"name":"refill","item":[{"name":"Refill","id":"f93652de-65be-4ccd-89e1-505eeb8ae1e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/refill?token=your_token","description":"<p>This method is used to retrieve the user's deposit address. The user must provide a valid authentication token, which can be obtained [<a href=\"https://t.me/re_fee_bot\">here</a>].</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/refill?token=your_token</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-address-to-top-up-the-users-balance\">200 Response (ОК): Address to top up the user's balance</h5>\n<p>Successful response. Returns information about the user's deposit address.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Refill Balance</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>username</code></td>\n<td>string</td>\n<td>Telegram username</td>\n<td><strong>username</strong></td>\n</tr>\n<tr>\n<td><code>full_name</code></td>\n<td>string</td>\n<td>Telegram full name</td>\n<td><strong>First Last</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>User balance in TRX</td>\n<td><strong>1500.2</strong></td>\n</tr>\n<tr>\n<td><code>address</code></td>\n<td>string</td>\n<td>Deposit address in TRC-20 format</td>\n<td><strong>THcKw2NNyvZBjrW3kNfTsN8vfzXLwzcd97</strong></td>\n</tr>\n<tr>\n<td><code>till</code></td>\n<td>number</td>\n<td>Timestamp by which the request must be fulfilled</td>\n<td><strong>1734643217</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>token</code> parameter is specified incorrectly, the request will return a <strong>403 response</strong> containing the following information:</p>\n<h5 id=\"403-response-error-no-user-by-token\"><strong>403 Response: Error: No user by token</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Refill balance</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>No user by token ...</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["refill"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"}],"variable":[]}},"response":[{"id":"fca3eb26-4a08-42b4-aff9-553d2137dcd0","name":"Address to top up the user's balance","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/refill?token=your_token","host":["https://api.refee.bot"],"path":["refill"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Refill Balance\",\n  \"ip\": \"1.1.1.1\",\n  \"username\": \"username\",\n  \"full_name\": \"First Last\",\n  \"balance\": 1500.2,\n  \"address\": \"THcKw2NNyvZBjrW3kNfTsN8vfzXLwzcd97\",\n  \"till\": 1734643217\n}"},{"id":"c7896696-dee2-414c-b64e-803f15303fe9","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/refill?token=your_token","host":["https://api.refee.bot"],"path":["refill"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Refill Balance\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"}],"_postman_id":"f93652de-65be-4ccd-89e1-505eeb8ae1e8"}],"id":"ae4965d1-87da-4536-bab4-45b1cfb069bc","_postman_id":"ae4965d1-87da-4536-bab4-45b1cfb069bc","description":""},{"name":"balance","item":[{"name":"Balance","id":"78993438-7f14-4ac3-8a6c-d74e4eb038ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/balance?token=your_token","description":"<p>This request is used to check the user's current balance. The user must provide a valid authentication token to execute the request.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/balance?token=your_token</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request-the-users-current-balance\">200 Response (ОК): Successful request. The user's current balance.</h5>\n<p>Successful response. Returns information about the user's current balance.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Check Balance</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>username</code></td>\n<td>string</td>\n<td>Telegram username</td>\n<td><strong>username</strong></td>\n</tr>\n<tr>\n<td><code>full_name</code></td>\n<td>string</td>\n<td>Telegram full name</td>\n<td><strong>First Last</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>User balance in TRX</td>\n<td><strong>1500.2</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>token</code> parameter is specified incorrectly, the request will return a <strong>403 response</strong> containing the following information:</p>\n<h5 id=\"403-response-error-no-user-by-token\"><strong>403 Response: Error: No user by token</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Check balance</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>No user by token ...</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["balance"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"}],"variable":[]}},"response":[{"id":"0ea66420-4730-42b1-b109-151fb5db9e54","name":"Successful request. The user's current balance.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/balance?token=your_token","host":["https://api.refee.bot"],"path":["balance"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Check Balance\",\n  \"ip\": \"1.1.1.1\",\n  \"username\": \"username\",\n  \"full_name\": \"First Last\",\n  \"balance\": 1500.2\n}"},{"id":"3ee45c9e-cead-4637-b59f-fc8e05d76147","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/balance?token=your_token","host":["https://api.refee.bot"],"path":["balance"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Check Balance\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"}],"_postman_id":"78993438-7f14-4ac3-8a6c-d74e4eb038ba"}],"id":"9fc85286-1778-470e-be30-f1f31f873cfb","_postman_id":"9fc85286-1778-470e-be30-f1f31f873cfb","description":""},{"name":"precountOrder","item":[{"name":"Precountorder","id":"04dd2d90-0167-46d4-be62-a5b89ba981a9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","description":"<p>This request is intended for the preliminary calculation of energy cost. To perform the request, the user must provide a valid authentication token and specify the energy usage period (<code>days</code>) and the energy volume (<code>volume</code>).</p>\n<p><strong>Limitations:</strong></p>\n<ul>\n<li><p>Minimum energy volume (<code>volume</code>): <strong>32K</strong>, maximum: <strong>4M</strong></p>\n</li>\n<li><p>The user's address must be <strong>activated</strong> in order to receive energy</p>\n</li>\n<li><p>Acceptable values for the energy usage period (<code>days</code>) are:</p>\n<ul>\n<li><p><code>1h</code> = 1 hour</p>\n</li>\n<li><p><code>1d</code> = 1 day</p>\n</li>\n<li><p><code>3d</code> = 3 days</p>\n</li>\n<li><p><code>7d</code> = 7 days</p>\n</li>\n<li><p><code>14d</code> = 14 days</p>\n</li>\n</ul>\n</li>\n</ul>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/precountOrder?token=your_token&amp;days=1d&amp;volume=1439604</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Energy usage period  <br />(Allowed values: 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)</td>\n<td><strong>7d</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>integer</td>\n<td>Energy volume  <br />(Allowed values: from 32K to 4M)</td>\n<td><strong>1439604</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request-calculated-energy-purchase-cost\">200 Response (ОК): Successful request. Calculated energy purchase cost.</h5>\n<p>Successful response. Returns the total energy cost based on the specified request parameters (usage duration and volume).</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Precount order</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>duration</code></td>\n<td>string</td>\n<td>Energy usage period</td>\n<td><strong>1h</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>number</td>\n<td>Energy volume</td>\n<td><strong>65000</strong></td>\n</tr>\n<tr>\n<td><code>price</code></td>\n<td>number</td>\n<td>Price for the specified energy volume, expressed in sun</td>\n<td><strong>111</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Total energy cost in TRX</td>\n<td><strong>5.55</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the parameters <code>token</code>, <code>days</code>, or <code>volume</code> are specified incorrectly, the request will return a <strong>403 response</strong> with an error message.</p>\n<h5 id=\"403-response-error\"><strong>403 Response: Error</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Precount order</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message. If the parameters are specified incorrectly, the following error messages will be returned:  <br /><code>token</code> - \"No user by token...\";  <br /><code>days</code> - \"➖ Возможные варианты: 1h, 1d, 3d, 7d, 14d\" (Possible values: 1h, 1d, 3d, 7d, 14d)  <br /><code>volume</code> - \"\\n\"</td>\n<td><strong>No user by token ...</strong>  <br />  <br /><strong>➖ Возможные варианты: 1h, 1d, 3d, 7d, 14d (Possible values: 1h, 1d, 3d, 7d, 14d)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>volume</code> parameter is passed with an empty value, the request will return a <strong>422 response</strong>.</p>\n<h5 id=\"422-response-unprocessable-entity-validation-error-missing-required-parameter-or-the-provided-value-is-incorrect\">422 Response (Unprocessable Entity): Validation error: Missing required parameter or the provided value is incorrect</h5>\n<p>Data validation error. Returns an array containing a description of the error type and the location of the incorrectly provided parameter. Upon receiving this response, you should check the correctness of the data sent in the request.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>loc</code></td>\n<td>array</td>\n<td>Indicates the location of the incorrectly provided parameter</td>\n<td><strong>\"volume\"</strong></td>\n</tr>\n<tr>\n<td><code>msg</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>\"Input should be a valid integer, unable to parse string as an integer\",\"input\":\"\"</strong></td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>string</td>\n<td>Error type</td>\n<td><strong>value_error.missing</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200, 403</strong> and <strong>422</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["precountOrder"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)</p>\n","type":"text/plain"},"key":"days","value":"7d"},{"description":{"content":"<p>(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)</p>\n","type":"text/plain"},"key":"volume","value":"1439604"}],"variable":[]}},"response":[{"id":"6d89ab13-7ac9-428d-8f3e-6331546bdad3","name":"Successful request. Calculated energy purchase cost.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","host":["https://api.refee.bot"],"path":["precountOrder"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount order\",\n  \"ip\": \"1.1.1.1\",\n  \"duration\": \"1h\",\n  \"volume\": 65000,\n  \"price\": 111,\n  \"summa\": 5.55\n}"},{"id":"76c4674d-fe3a-4b2c-8b7a-772471f19827","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","host":["https://api.refee.bot"],"path":["precountOrder"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)"}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount order\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"690ce967-3278-4fe9-9dce-e476cb490f13","name":"Invalid request. Provided value 'days' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","host":["https://api.refee.bot"],"path":["precountOrder"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)"}]}},"status":"Error: Provided value 'days' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount order\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"➖  Возможные варианты: 1h, 1d, 3d, 7d, 14d\\n1000000\"\n}"},{"id":"80fea94b-105f-40c3-81aa-0a53bd24df84","name":"Invalid request. Provided value 'volume' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","host":["https://api.refee.bot"],"path":["precountOrder"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)"}]}},"status":"Error: Provided value 'volume' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount order\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"\\n\"\n}"},{"id":"fbcef270-d7b6-4e1c-92cb-626614f5b629","name":"Validation error: Missing required parameter or the provided value is incorrect\n","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountOrder?token=your_token&days=7d&volume=1439604","host":["https://api.refee.bot"],"path":["precountOrder"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume for cost calculation (Allowed values range from 32K to 4M)"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": [\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    },\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    }\n  ]\n}"}],"_postman_id":"04dd2d90-0167-46d4-be62-a5b89ba981a9"}],"id":"c9c41eb6-efe5-4513-b116-4d529b2e60e8","_postman_id":"c9c41eb6-efe5-4513-b116-4d529b2e60e8","description":""},{"name":"precountBandwidth","item":[{"name":"precountBandwidth","id":"78409748-8cd6-4fee-aeaf-ca17f7c09d6c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","description":"<p>This request performs a preliminary calculation of bandwidth cost. To execute the request, the user must provide a valid authentication token, as well as specify the bandwidth usage period (<code>days</code>) and the bandwidth volume (<code>volume</code>).</p>\n<p><strong>Limitations:</strong></p>\n<ul>\n<li><p>Minimum bandwidth volume (<code>volume</code>): <strong>1K</strong>, maximum: <strong>300K</strong></p>\n</li>\n<li><p>The user's address must be <strong>activated</strong> to receive bandwidth</p>\n</li>\n<li><p>Acceptable values for the bandwidth usage period (<code>days</code>) are:</p>\n<ul>\n<li><p><code>1h</code> = 1 hour</p>\n</li>\n<li><p><code>6h</code> = 6 hours</p>\n</li>\n<li><p><code>3d</code> = 3 days</p>\n</li>\n<li><p><code>7d</code> = 7 days</p>\n</li>\n<li><p><code>14d</code> = 14 days</p>\n</li>\n</ul>\n</li>\n</ul>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/precountBandwidth?token=your_token&amp;days=3d&amp;volume=10000</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Bandwidth usage period  <br />(Allowed values: 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)</td>\n<td><strong>7d</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>integer</td>\n<td>Bandwidth volume  <br />(Allowed values: from 1K to 300K)</td>\n<td><strong>1439604</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request-calculated-bandwidth-purchase-cost\">200 Response (ОК): Successful request. Calculated bandwidth purchase cost.</h5>\n<p>Successful response. Returns the total bandwidth cost based on the specified request parameters (usage duration and volume).</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Precount bandwidth</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>duration</code></td>\n<td>string</td>\n<td>Bandwidth usage period</td>\n<td><strong>3d</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>number</td>\n<td>Bandwidth volume</td>\n<td><strong>1000</strong></td>\n</tr>\n<tr>\n<td><code>price</code></td>\n<td>number</td>\n<td>Price for the specified bandwidth volume, expressed in sun</td>\n<td><strong>750</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Total bandwidth cost in TRX</td>\n<td><strong>1.05</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the parameters <code>token</code>, <code>days</code>, or <code>volume</code> are specified incorrectly, the request will return a <strong>403 response</strong>.</p>\n<p><strong>403 Response: Error:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Precount bandwidth</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message. If the parameters are specified incorrectly, the following error messages will be returned:  <br /><code>token</code> - \"No user by token...\";  <br /><code>days</code> - \"➖ Возможные варианты: 1h, 6h, 3d, 7d, 14d\" (Possible values: 1h, 6h, 3d, 7d, 14d)  <br /><code>volume</code> - \"\\n\"</td>\n<td><strong>No user by token ...</strong>  <br />  <br /><strong>➖ Возможные варианты: 1h, 6h, 3d, 7d, 14d (Possible values: 1h, 6h, 3d, 7d, 14d)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>volume</code> parameter is passed with an empty value, the request will return a <strong>422 response</strong>.</p>\n<h5 id=\"422-response-unprocessable-entity-validation-error-missing-required-parameter-or-the-provided-value-is-incorrect\">422 Response (Unprocessable Entity): Validation error: Missing required parameter or the provided value is incorrect</h5>\n<p>Data validation error. Returns an array containing a description of the error type and the location of the incorrectly provided parameter. Upon receiving this response, you should check the correctness of the data sent in the request.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>loc</code></td>\n<td>array</td>\n<td>Indicates the location of the incorrectly provided parameter</td>\n<td><strong>\"volume\"</strong></td>\n</tr>\n<tr>\n<td><code>msg</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>The field \\\"token\\\" is required</strong></td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>string</td>\n<td>Error type</td>\n<td><strong>\"Input should be a valid integer, unable to parse string as an integer\",\"input\":\"\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200, 403</strong> and <strong>422</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["precountBandwidth"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)</p>\n","type":"text/plain"},"key":"days","value":"7d"},{"description":{"content":"<p>(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)</p>\n","type":"text/plain"},"key":"volume","value":"1503327"}],"variable":[]}},"response":[{"id":"8cfa7d4d-046b-403b-a983-a30185c2f04a","name":"Successful request. Calculated bandwidth purchase cost.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","protocol":"https","host":["api","refee","bot"],"path":["precountBandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"duration\": \"3d\",\n  \"volume\": 1000,\n  \"price\": 750,\n  \"summa\": 1.05\n}"},{"id":"bc72a1c2-04fe-42cb-95fe-7c26210c2e7b","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","host":["https://api.refee.bot"],"path":["precountBandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)"}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"ebef8701-de8b-48a5-a0f8-31b7ea558e4c","name":"Invalid request. Provided value 'days' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","host":["https://api.refee.bot"],"path":["precountBandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)"}]}},"status":"Error: Provided value 'days' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"➖  Возможные варианты: 1h, 6h, 3d, 7d, 14d\\n300000\"\n}"},{"id":"f11d9bce-b634-41bd-83bf-dd9e30e90727","name":"Invalid request. Provided value 'volume' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","host":["https://api.refee.bot"],"path":["precountBandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)"}]}},"status":"Error: Provided value 'volume' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Precount Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"\\n\"\n}"},{"id":"b79f722e-7376-43d3-87fa-fad8a42b816c","name":"Validation error: Missing required parameter or the provided value is incorrect\n","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/precountBandwidth?token=your_token&days=7d&volume=1503327","protocol":"https","host":["api","refee","bot"],"path":["precountBandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume for cost calculation (Allowed values range from 1K to 300K)"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"detail\": [\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    },\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    }\n  ]\n}"}],"_postman_id":"78409748-8cd6-4fee-aeaf-ca17f7c09d6c"}],"id":"2e6a3ff4-c536-4324-b5c1-cbc4d57677a4","_postman_id":"2e6a3ff4-c536-4324-b5c1-cbc4d57677a4","description":""},{"name":"cost","item":[{"name":"Precount energy by target addresses","id":"b022d012-2164-49e3-b733-b63f18f2b670","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/cost?token=your_token&targets=TrxAddress","description":"<p>Request for calculating the amount of energy required to be sent to the specified addresses. The <code>targets</code> parameter should contain up to 20 TRC-20 formatted addresses, separated by commas.</p>\n<p>As a result, the user receives a list consisting of the provided addresses along with the calculated energy amount for each address.</p>\n<p><strong>Request Example:</strong><br /><code>GET https://api.refee.bot/cost?token=your_token&amp;targets=TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD,TCCbXdPQDRRbdNGiGEE581Wet1mJ4WJPmS</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>targets</code></td>\n<td>string</td>\n<td>Address in TRC-20 format  <br />(Values must be comma-separated, with no more than 20 addresses per request)</td>\n<td><strong>TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD, TCCbXdPQDRRbdNGiGEE581Wet1mJ4WJPmS</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request-calculated-energy-volume\">200 Response (ОК): Successful request. Calculated energy volume.</h5>\n<p>Successful response. Returns a list of addresses and the calculated energy amount for each address.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Cost Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>string</td>\n<td>An array containing a list of addresses with the calculated energy amount for each address</td>\n<td><strong>\"address\" : TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD, \"need_energy\" : 65000</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>token</code> parameter is specified incorrectly, the request will return a <strong>403 response</strong> containing the following information:</p>\n<p><strong>403 Response: Error: No user by token</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Cost Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>No user by token ...</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>targets</code> parameter is specified incorrectly, the request will also return a <strong>403 response</strong>.</p>\n<p><strong>403 Response: Error: At least one valid address is required.</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Cost Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>At least one valid address is required.</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["cost"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Comma separated list of addresses (TRC-20). No more than 20 at a time.</p>\n","type":"text/plain"},"key":"targets","value":"TrxAddress"}],"variable":[]}},"response":[{"id":"fbebd0b2-bc96-4e89-b636-645e99827cae","name":"Successful request. Calculated energy volume.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/cost?token=your_token&targets=TrxAddress","host":["https://api.refee.bot"],"path":["cost"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"targets","value":"TrxAddress","description":"(Required) Comma separated list of addresses (TRC-20). No more than 20 at a time."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Cost Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"data\": [\n    {\n      \"address\": \"TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD\",\n      \"need_energy\": 65000\n    }\n  ]\n}"},{"id":"3aa00d6a-23cc-4048-a703-121b56c3a15b","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/cost?token=your_token&targets=TrxAddress","host":["https://api.refee.bot"],"path":["cost"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"targets","value":"TrxAddress","description":"(Required) Comma separated list of addresses (TRC-20). No more than 20 at a time."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Cost Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"16a700e9-5fd5-4dce-ac14-15d5fe808bd8","name":"Invalid request. At least one valid address is required","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/cost?token=your_token&targets=TrxAddress","host":["https://api.refee.bot"],"path":["cost"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"targets","value":"TrxAddress","description":"(Required) Comma separated list of addresses (TRC-20). No more than 20 at a time."}]}},"status":"Error: At least one valid address is required","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Cost Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"At least one valid address is required.\"\n}\n"}],"_postman_id":"b022d012-2164-49e3-b733-b63f18f2b670"}],"id":"9cfc3e1e-72e8-4d76-910f-34b8f7d49cd3","_postman_id":"9cfc3e1e-72e8-4d76-910f-34b8f7d49cd3","description":""},{"name":"buyenergy","item":[{"name":"Buyenergy","id":"db3be63d-9ee9-4951-a5aa-944de1814c65","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","description":"<p>This request is intended for purchasing energy. To execute the request, the user must provide a valid authentication token (<code>token</code>) and specify the energy usage period (<code>days</code>), the energy volume (<code>volume</code>), and the TRC-20 address (<code>target</code>) to which the energy should be sent.</p>\n<p><strong>Limitations:</strong></p>\n<ul>\n<li><p>Minimum energy volume (<code>volume</code>): <strong>32K</strong>, maximum: <strong>4M</strong></p>\n</li>\n<li><p>The user's address must be <strong>activated</strong> in order to receive energy</p>\n</li>\n<li><p>Acceptable values for the energy usage period (<code>days</code>) are:</p>\n<ul>\n<li><p><code>1h</code> = 1 hour</p>\n</li>\n<li><p><code>1d</code> = 1 day</p>\n</li>\n<li><p><code>3d</code> = 3 days</p>\n</li>\n<li><p><code>7d</code> = 7 days</p>\n</li>\n<li><p><code>14d</code> = 14 days</p>\n</li>\n</ul>\n</li>\n</ul>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/buyenergy?token=your_token&amp;days=1d&amp;volume=1439604&amp;target=TrxAddress</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Energy usage period  <br />(Allowed values: 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)</td>\n<td><strong>7d</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>integer</td>\n<td>Energy volume  <br />(Allowed values: from 32K to 4M)</td>\n<td><strong>1439604</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format</td>\n<td><strong>TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-the-request-was-successfully-completed-information-about-the-energy-purchase-and-the-status-of-the-operation-is-returned\">200 Response (ОК): The request was successfully completed. Information about the energy purchase and the status of the operation is returned.</h5>\n<p>The response contains information about the operation status, the cost of the operation, and the transaction ID (if the request was successfully completed).</p>\n<p><strong>Possible operation statuses:</strong></p>\n<ul>\n<li><p><strong>Filled</strong> – Purchase completed. Energy was successfully transferred.</p>\n</li>\n<li><p><strong>Pending</strong> – Energy is being transferred.</p>\n</li>\n<li><p><strong>Canceled</strong> – The purchase has been canceled.</p>\n</li>\n<li><p><strong>NoBalance</strong> – No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</p>\n</li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Energy usage period</td>\n<td><strong>1h</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>number</td>\n<td>Energy volume</td>\n<td><strong>32000</strong></td>\n</tr>\n<tr>\n<td><code>price</code></td>\n<td>number</td>\n<td>Price for the specified energy volume, expressed in sun</td>\n<td><strong>111</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Total energy cost in TRX</td>\n<td><strong>3.552</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Recipient address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>User balance in TRX</td>\n<td><strong>555</strong></td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Operation status.  <br />Possible operation statuses:  <br /><strong>Filled</strong> – Purchase completed. Energy was successfully transferred.  <br /><strong>Pending</strong> – Energy is being transferred.  <br /><strong>Canceled</strong> – The purchase has been canceled.  <br /><strong>NoBalance</strong> – No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</td>\n<td><strong>Filled</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>number</td>\n<td>Order ID</td>\n<td><strong>554543</strong></td>\n</tr>\n<tr>\n<td><code>txid</code>(displayed when the status is \"Filled\")</td>\n<td>string</td>\n<td>Transaction hash</td>\n<td><strong>c71c80e8d51af26f7a3a5535c94b2c3b1b723e39bee3597fa90be1a01a1b0991</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the parameters <code>token</code>, <code>days</code>, or <code>volume</code> are specified incorrectly, the request will return a <strong>403 response</strong>.</p>\n<p><strong>403 Response: Error:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message. If the parameters are specified incorrectly, the following error messages will be returned:  <br /><code>token</code> - \"No user by token...\";  <br /><code>days</code> - \"➖ Возможные варианты: 1h, 1d, 3d, 7d, 14d\" (Possible values: 1h, 1d, 3d, 7d, 14d)  <br /><code>volume</code> - \"\\n\"</td>\n<td><strong>No user by token ...</strong>  <br />  <br /><strong>➖ Возможные варианты: 1h, 1d, 3d, 7d, 14d\" (Possible values: 1h, 1d, 3d, 7d, 14d)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the user provides an incorrect address in the <code>target</code> parameter, the request will return a <strong>400 response</strong>.</p>\n<h5 id=\"400-response-error-request-error\">400 Response (Error): Request error.</h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Energy</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was madeс</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td>**Request error: ➖ <strong>...\\nНе похоже на TRX адрес. Должно быть 34 символа.</strong> <strong>(Invalid TRX address. It should be 34 characters long)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>volume</code> parameter is passed with an empty value, the request will return a <strong>422 response</strong>.</p>\n<h5 id=\"422-response-unprocessable-entity-validation-error-missing-required-parameter-or-the-provided-value-is-incorrect\">422 Response (Unprocessable Entity): Validation error: Missing required parameter or the provided value is incorrect</h5>\n<p>Data validation error. Returns an array containing a description of the error type and the location of the incorrectly provided parameter. Upon receiving this response, you should check the correctness of the data sent in the request.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>loc</code></td>\n<td>array</td>\n<td>Indicates the location of the incorrectly provided parameter</td>\n<td><strong>\"volume\"</strong></td>\n</tr>\n<tr>\n<td><code>msg</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>\"Input should be a valid integer, unable to parse string as an integer\",\"input\":\"\"</strong></td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>string</td>\n<td>Error type</td>\n<td><strong>value_error.missing</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200, 400, 403</strong> and <strong>422</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["buyenergy"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)</p>\n","type":"text/plain"},"key":"days","value":"7d"},{"description":{"content":"<p>(Required) Energy volume (Allowed values range from 32K to 4M)</p>\n","type":"text/plain"},"key":"volume","value":"1439604"},{"description":{"content":"<p>(Required) The address to which the energy is transferred (TRC-20).</p>\n","type":"text/plain"},"key":"target","value":"TrxAddress"}],"variable":[]}},"response":[{"id":"e5f56574-471b-489b-a8bc-404fb6254b78","name":"Energy has been successfully transferred","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","protocol":"https","host":["api","refee","bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 65000,\n  \"price\": 90,\n  \"summa\": 5.85,\n  \"target\": \"TTve1fBTbswndPq99iREv72tkLZ6mBSgJH\",\n  \"balance\": 130.18190500000003,\n  \"status\": \"Filled\",\n  \"order_id\": 4708742,\n  \"txid\": \"7b1943d00451814c2ea03d6a1196a301ca10e89dfd53536e34f09bfa9aeed0e7\"\n}"},{"id":"4c6d1995-838f-4bbd-9561-9491cb708044","name":"Energy is being transferred","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 32000,\n  \"price\": 111,\n  \"summa\": 3.552,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Pending\"\n}"},{"id":"a4ea9e71-7acd-42f0-b6be-17673a61cad2","name":"The purchase has been cancelled.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 32000,\n  \"price\": 111,\n  \"summa\": 3.552,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Canceled\"\n}"},{"id":"1d370e1e-7124-41fb-b69e-e201494f7925","name":"Insufficient funds.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"192.167.0.1\",\n  \"days\": \"1h\",\n  \"volume\": 32000,\n  \"price\": 111,\n  \"summa\": 3.552,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 1,\n  \"status\": \"NO BALANCE! Replenish your balance through the bot https://t.me/re_fee_bot or use /refill to get the replenishment address.\"\n}"},{"id":"f16dc495-623b-492b-8b05-74feb4e91723","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"29e86ead-d1aa-4d28-b1c1-448a82f7ff09","name":"Invalid request. Provided value 'days' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"Error: Provided value 'days' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"➖  Возможные варианты: 1h, 1d, 3d, 7d, 14d\\n1000000\"\n}"},{"id":"8ff177f2-8ec6-4929-955c-11982d5a834e","name":"Invalid request. Provided value 'volume' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"Error: Provided value 'volume' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"\\n\"\n}"},{"id":"0a6cc832-08f3-42f0-aec5-75459060a193","name":"Request error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"Request error","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"Request error: \\n➖  <b>...</b>\\nНе похоже на TRX адрес. Должно быть 34 символа.\"\n}"},{"id":"d1ddc1ab-d56c-4043-8dd3-cc5c25a35880","name":"ValidationError: Missing required parameter or the provided value is incorrect\n","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buyenergy?token=your_token&days=7d&volume=1439604&target=TrxAddress","host":["https://api.refee.bot"],"path":["buyenergy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Energy duration period (Possible values, 1h = 1 hour, 1d = 1 day, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1439604","description":"(Required) Energy volume (Allowed values range from 32K to 4M)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the energy is transferred (TRC-20)."}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": [\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    },\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    }\n  ]\n}"}],"_postman_id":"db3be63d-9ee9-4951-a5aa-944de1814c65"}],"id":"69328ed9-2e45-4c16-92d5-699e1a63d63d","_postman_id":"69328ed9-2e45-4c16-92d5-699e1a63d63d","description":""},{"name":"buybandwidth","item":[{"name":"BuyBandwidth","id":"0199256c-2f4f-4249-b1ff-1b6d27b1f835","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","description":"<p>This request is intended for purchasing bandwidth.</p>\n<p>To execute the request, the user must provide a valid authentication token (<code>token</code>) and specify the bandwidth usage period (<code>days</code>), the bandwidth volume (<code>volume</code>), and the recipient TRC-20 address (<code>target</code>).</p>\n<p><strong>Limitations:</strong></p>\n<ul>\n<li><p>Minimum bandwidth volume (<code>volume</code>): <strong>1K</strong>, maximum: <strong>300K</strong></p>\n</li>\n<li><p>The user's address must be <strong>activated</strong> to receive bandwidth</p>\n</li>\n<li><p>Acceptable values for the bandwidth usage period (<code>days</code>) are:</p>\n<ul>\n<li><p><code>1h</code> = 1 hour</p>\n</li>\n<li><p><code>6h</code> = 6 hours</p>\n</li>\n<li><p><code>3d</code> = 3 days</p>\n</li>\n<li><p><code>7d</code> = 7 days</p>\n</li>\n<li><p><code>14d</code> = 14 days</p>\n</li>\n</ul>\n</li>\n</ul>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/buybandwidth?token=your_token&amp;days=3d&amp;volume=1000&amp;target=TrxAddress</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Bandwidth usage period  <br />(Allowed values: 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)</td>\n<td><strong>7d</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>integer</td>\n<td>Bandwidth volume  <br />(Allowed values: from 1K to 300K)</td>\n<td><strong>1439604</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format</td>\n<td><strong>TUo8pycbvje9w2XYsNnnzw67bpPs4GLFyD</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-the-request-was-successfully-completed-information-about-the-bandwidth-purchase-and-the-status-of-the-operation-is-returned\">200 Response (ОК): The request was successfully completed. Information about the bandwidth purchase and the status of the operation is returned.</h5>\n<p>The response contains information about the operation status, the cost of the operation, and the transaction ID (if the request was successfully completed).</p>\n<p><strong>Possible operation statuses:</strong></p>\n<ul>\n<li><p><strong>Filled</strong> – Purchase completed. Bandwidth was successfully transferred.</p>\n</li>\n<li><p><strong>Pending</strong> – Bandwidth is being transferred.</p>\n</li>\n<li><p><strong>Canceled</strong> – The purchase has been canceled.</p>\n</li>\n<li><p><strong>NoBalance</strong> – No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</p>\n</li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Bandwidth</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td>string</td>\n<td>Bandwidth usage period</td>\n<td><strong>1h</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>number</td>\n<td>Bandwidth volume</td>\n<td><strong>1000</strong></td>\n</tr>\n<tr>\n<td><code>price</code></td>\n<td>number</td>\n<td>Price for the specified bandwidth volume, expressed in sun</td>\n<td><strong>750</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Total bandwidth cost in TRX</td>\n<td><strong>1.05</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Bandwidth recipient address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>User balance in TRX</td>\n<td><strong>555</strong></td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Operation status. Possible operation statuses:  <br /><strong>Filled</strong> – Purchase completed. Bandwidth was successfully transferred.  <br /><strong>Pending</strong> – Bandwidth is being transferred.  <br /><strong>Canceled</strong> – The purchase has been canceled.  <br /><strong>NoBalance</strong> – No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</td>\n<td><strong>Filled</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>number</td>\n<td>Order ID</td>\n<td><strong>554543</strong></td>\n</tr>\n<tr>\n<td><code>txid</code> (displayed when the status is \"Filled\")</td>\n<td>string</td>\n<td>Transaction hash</td>\n<td><strong>c71c80e8d51af26f7a3a5535c94b2c3b1b723e39bee3597fa90be1a01a1b0991</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the parameters <code>token</code>, <code>days</code>, or <code>volume</code> are specified incorrectly, the request will return a <strong>403 response</strong>.</p>\n<p><strong>403 Response: Error:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Bandwidth</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message. If the parameters are specified incorrectly, the following error messages will be returned:  <br /><code>token</code> - \"No user by token...\";  <br /><code>days</code> - \"➖ Возможные варианты: 1h, 6h, 3d, 7d, 14d\" (Possible values: 1h, 6h, 3d, 7d, 14d)  <br /><code>volume</code> - \"\\n\"</td>\n<td><strong>No user by token ...</strong>  <br />  <br /><strong>➖ Возможные варианты: 1h, 6h, 3d, 7d, 14d (Possible values: 1h, 6h, 3d, 7d, 14d)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the user provides an incorrect address in the <code>target</code> parameter, the request will return a <strong>400 response</strong>.</p>\n<h5 id=\"400-response-error-request-error\">400 Response (Error): Request error.</h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Buying Bandwidth</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td>**Request error: ➖ <strong>...\\nНе похоже на TRX адрес. Должно быть 34 символа.</strong> <strong>(Invalid TRX address. It should be 34 characters long)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>volume</code> parameter is passed with an empty value, the request will return a <strong>422 response</strong>.</p>\n<h5 id=\"422-response-unprocessable-entity-validation-error-missing-required-parameter-or-the-provided-value-is-incorrect\">422 Response (Unprocessable Entity): Validation error: Missing required parameter or the provided value is incorrect</h5>\n<p>Data validation error. Returns an array containing a description of the error type and the location of the incorrectly provided parameter. Upon receiving this response, you should check the correctness of the data sent in the request.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>loc</code></td>\n<td>array</td>\n<td>Indicates the location of the incorrectly provided parameter</td>\n<td><strong>\"volume\"</strong></td>\n</tr>\n<tr>\n<td><code>msg</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>The field \\\"token\\\" is required</strong></td>\n</tr>\n<tr>\n<td><code>type</code></td>\n<td>string</td>\n<td>Error type</td>\n<td><strong>\"Input should be a valid integer, unable to parse string as an integer\",\"input\":\"\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200, 400, 403</strong> and <strong>422</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["buybandwidth"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)</p>\n","type":"text/plain"},"key":"days","value":"7d"},{"description":{"content":"<p>(Required) Bandwidth volume (Allowed values range from 1K to 300K)</p>\n","type":"text/plain"},"key":"volume","value":"1503327"},{"description":{"content":"<p>(Required) The address to which the bandwidth is transferred (TRC-20).</p>\n","type":"text/plain"},"key":"target","value":"TrxAddress"}],"variable":[]}},"response":[{"id":"c7a5474a-3869-4ea6-ac55-675a0dab576b","name":"Bandwidth has been successfully transferred","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","protocol":"https","host":["api","refee","bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 1000,\n  \"price\": 750,\n  \"summa\": 1.05,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Filled\",\n  \"order_id\": 333333,\n  \"txid\": \"c71c80e8d51af26f7a3a5535c94b2c3b1b723e39bee3597fa90be1a01a1b0991\"\n}"},{"id":"83d9d76b-62e3-402a-bd96-c62b0ed2539a","name":"Buying is being transferred","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 1000,\n  \"price\": 750,\n  \"summa\": 1.05,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Pending\"\n}"},{"id":"4670662e-4671-4b70-9f1d-94b8aaa73bc5","name":"The purchase has been cancelled.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"days\": \"1h\",\n  \"volume\": 1000,\n  \"price\": 750,\n  \"summa\": 1.05,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Canceled\"\n}"},{"id":"7589df5a-0cca-42ce-bdcd-c11f627b520b","name":"Insufficient funds.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Energy\",\n  \"ip\": \"192.167.0.1\",\n  \"days\": \"1h\",\n  \"volume\": 1000,\n  \"price\": 750,\n  \"summa\": 1.05,\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 1,\n  \"status\": \"NO BALANCE! Replenish your balance through the bot https://t.me/re_fee_bot or use /refill to get the replenishment address.\"\n}"},{"id":"e906eda2-7eef-4172-bba7-7e6ab2f51986","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"Forbidden. No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"c90c224a-f55e-4621-ad70-ecd8fb60ef8e","name":"Invalid request. Provided value 'days' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"Error: Provided value 'days' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"➖  Возможные варианты: 1h, 6h, 3d, 7d, 14d\\n1000000\"\n}"},{"id":"19e017b2-07aa-4cef-8ea3-0a873b9ca3ac","name":"Invalid request. Provided value 'volume' is incorrect","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"Error: Provided value 'volume' is incorrect","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"\\n\"\n}"},{"id":"91b9368c-44e0-4fd3-9f2a-c0d2dcf8a074","name":"Request error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"Request error","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Buying Bandwidth\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"Request error: \\nTRX ERR: ➖  <b>gunreusP7q5yCvbGoeAVEJL1qjChd</b>\\nНе похоже на TRX адрес. Должно быть 34 символа.\"\n}"},{"id":"5ea0b411-40b1-40b0-b56e-44dfcec3fcde","name":"ValidationError: Missing required parameter or the provided value is incorrect\n","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/buybandwidth?token=your_token&days=7d&volume=1503327&target=TrxAddress","host":["https://api.refee.bot"],"path":["buybandwidth"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"days","value":"7d","description":"(Required) Bandwidth duration period (Possible values, 1h = 1 hour, 6h = 6 hours, 3d = 3 days, 7d = 7 days, 14d = 14 days)"},{"key":"volume","value":"1503327","description":"(Required) Bandwidth volume (Allowed values range from 1K to 300K)"},{"key":"target","value":"TrxAddress","description":"(Required) The address to which the bandwidth is transferred (TRC-20)."}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": [\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    },\n    {\n      \"loc\": [\n        \"query\",\n        \"token\"\n      ],\n      \"msg\": \"The field \\\"token\\\" is required\",\n      \"type\": \"value_error.missing\"\n    }\n  ]\n}"}],"_postman_id":"0199256c-2f4f-4249-b1ff-1b6d27b1f835"}],"id":"16fe0c79-94f8-44b8-a3df-12f5aeb84630","_postman_id":"16fe0c79-94f8-44b8-a3df-12f5aeb84630","description":""},{"name":"activate","item":[{"name":"activate address","id":"5bd47990-404f-466c-a6de-11fe749a6281","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","description":"<p>This request is used for activating a TRC-20 address. The request parameters must include the user's valid authentication token (<code>token</code>) and the unactivated TRC-20 address.</p>\n<blockquote>\n<p><strong>Note:</strong> The request does not include a verification of the activation status of the address. If the user specifies an already activated address, the activation transaction will still be executed, and <strong>1.7 TRX</strong> will be deducted from the user's balance for the transaction. </p>\n</blockquote>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/activate?token=your_token&amp;target=TrxAddress</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address (TRC-20) to be activated</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-the-request-was-successfully-completed\">200 Response (ОК): The request was successfully completed.</h5>\n<p>The response contains information about the operation status, the cost of the operation, and the transaction ID (if the request was successfully completed).</p>\n<p><strong>Possible operation statuses:</strong></p>\n<p><strong>Activated address...</strong> - Address has been successfully activated.</p>\n<p><strong>Canceled</strong> - The activation has been cancelled.</p>\n<p><strong>NoBalance</strong> - No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Activate address</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Activation address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>Current user balance in TRX</td>\n<td><strong>1000</strong></td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Operation status. Possible operation statuses:  <br /><strong>Activated address...</strong> - Address has been successfully activated.  <br /><strong>Canceled</strong> - The activation has been cancelled.  <br /><strong>NoBalance</strong> - No Balance! Replenish your balance through the bot <a href=\"https://t.me/re_fee_bot\">https://t.me/re_fee_bot</a> or use /refill to get the replenishment address.</td>\n<td><strong>Activated address</strong> <strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>number</td>\n<td>Order ID</td>\n<td><strong>554543</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Total address activation cost in TRX</td>\n<td><strong>1.7</strong></td>\n</tr>\n<tr>\n<td><code>txid</code></td>\n<td>string</td>\n<td>Transaction hash</td>\n<td><strong>c71c80e8d51af26f7a3a5535c94b2c3b1b723e39bee3597fa90be1a01a1b0991</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"403-response-error-no-user-by-token\">403 Response (Error): No User by token.</h5>\n<p>If the <code>token</code> parameter is specified incorrectly, the <code>/activate</code> request will return a <strong>403 response</strong> containing the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>error</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>No User by token : ...</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the user provides an incorrect address in the <code>target</code> parameter, the request will return a <strong>400 response</strong>.</p>\n<h5 id=\"400-response-error-request-error\">400 Response (Error): Request error.</h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Activate address</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td>**Request error: ➖ <strong>...\\nНе похоже на TRX адрес. Должно быть 34 символа.</strong> <strong>(Invalid TRX address. It should be 34 characters long)</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200, 400,</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["activate"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Not activated address (TRC-20).</p>\n","type":"text/plain"},"key":"target","value":"TrxAddress"}],"variable":[]}},"response":[{"id":"d18fb831-700b-4ca5-aff2-0b5be7994637","name":"Address has been successfully activated","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","host":["https://api.refee.bot"],"path":["activate"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Not activated address (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Activate address\",\n  \"ip\": \"1.1.1.1\",\n  \"target\": \"TTve1fBTbswndPq99iREv72tkLZ6mBSgJH\",\n  \"balance\": 136.03190500000002,\n  \"status\": \"Activated address TTve1fBTbswndPq99iREv72tkLZ6mBSgJH\",\n  \"order_id\": 10719,\n  \"summa\": 1.7,\n  \"txid\": \"696caca6a9eacb343e283c1a4c83f721442c25cecd9f06d3f3f07aa5addd72bc\"\n}"},{"id":"d4e2f9fc-8f88-4093-8026-8ee61371bf34","name":"The activation has been cancelled.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","host":["https://api.refee.bot"],"path":["activate"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Not activated address (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Activate address\",\n  \"ip\": \"1.1.1.1\",\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"balance\": 555,\n  \"status\": \"Canceled\"\n}"},{"id":"1f9f8b46-41b3-46e2-97aa-db0e82a54eed","name":"Insufficient funds.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","host":["https://api.refee.bot"],"path":["activate"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Not activated address (TRC-20)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Activate address\",\n  \"ip\": \"1.1.1.1\",\n  \"target\": \"TTve1fBTbswndPq99iREv72tkLZ6mBSgJH\",\n  \"balance\": 0.5999999999999999,\n  \"status\": \"NO BALANCE! Replenish your balance through the bot https://t.me/re_fee_bot or use /refill to get the replenishment address.\"\n}"},{"id":"0c88d3eb-2d80-4c3e-b0d9-b73d90549e10","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","host":["https://api.refee.bot"],"path":["activate"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Not activated address (TRC-20)."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Activate address\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"},{"id":"820f1f4b-534f-401c-a932-cf65f0fc27b5","name":"Request error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/activate?token=your_token&target=TrxAddress","host":["https://api.refee.bot"],"path":["activate"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Not activated address (TRC-20)."}]}},"status":"Request error","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Activate address\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"Request error: ➖  <b>Tve1fBTbswndPq99iREv72tkLZ6mBSgJH</b>\\nНе похоже на TRX адрес. Должно быть 34 символа.\"\n}"}],"_postman_id":"5bd47990-404f-466c-a6de-11fe749a6281"}],"id":"4f03c77b-2024-4351-a31e-48465bd241c3","_postman_id":"4f03c77b-2024-4351-a31e-48465bd241c3","description":""},{"name":"status","item":[{"name":"Status","id":"cdaf4814-5f8a-4fc3-b3db-dc30454b50d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/status?token=your_token&order_id=order_id","description":"<p>This request is used to check the current status of a user's order.</p>\n<p>To execute the request, the user must provide a valid authentication token (<code>token</code>) and the <code>order_id</code> assigned during a <code>/buyenergy</code> or <code>/buybandwidth</code> request.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/status?token=your_token&amp;order_id=123456</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>integer</td>\n<td>Order ID</td>\n<td><strong>554543</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request-order-status-information-returned\">200 Response (ОК): Successful request. Order status information returned.</h5>\n<p>The response contains information about the order status. It also includes the cost of the operation and the transaction ID (if the order was successfully completed).</p>\n<p><strong>Possible operation statuses:</strong></p>\n<ul>\n<li><p><strong>Filled</strong> – The order was successfully completed.</p>\n</li>\n<li><p><strong>Pending</strong> – The order is in progress.</p>\n</li>\n<li><p><strong>Canceled</strong> – The order has been canceled.</p>\n</li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Status order</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>number</td>\n<td>Order ID</td>\n<td><strong>554543</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Order recipient address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>duration</code></td>\n<td>string</td>\n<td>Energy/Bandwidth usage period specified in the order</td>\n<td><strong>1h</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>number</td>\n<td>Energy/Bandwidth volume specified in the order</td>\n<td><strong>32000</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Cost of the completed order in TRX</td>\n<td><strong>4</strong></td>\n</tr>\n<tr>\n<td><code>txid</code>(displayed when the status is \"Filled\")</td>\n<td>string</td>\n<td>Transaction hash</td>\n<td><strong>c71c80e8d51af26f7a3a5535c94b2c3b1b723e39bee3597fa90be1a01a1b0991</strong></td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Order status. Possible statuses: <strong>Filled</strong> - The order was successfully completed.  <br /><strong>Pending</strong> - The order is in progress.  <br /><strong>Canceled</strong> - The order has been canceled.</td>\n<td><strong>Filled</strong></td>\n</tr>\n<tr>\n<td><code>tm</code></td>\n<td>number</td>\n<td>Order completion timestamp</td>\n<td><strong>1734643217</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>order_id</code> parameter is specified incorrectly, the <code>/status</code> request will return a <strong>200 response</strong> containing the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Status order</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>Not your order_id</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If the <code>token</code> parameter is specified incorrectly, the <code>/status</code> request will return a <strong>403 response</strong> containing the following information:</p>\n<h5 id=\"403-response-error-no-user-by-token\"><strong>403 Response: Error: No user by token</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Request name</td>\n<td><strong>Status order</strong></td>\n</tr>\n<tr>\n<td><code>ip</code></td>\n<td>string</td>\n<td>IP address of the device from which the request was made</td>\n<td><strong>1.1.1.1</strong></td>\n</tr>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>No user by token ...</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["status"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Order ID.</p>\n","type":"text/plain"},"key":"order_id","value":"order_id"}],"variable":[]}},"response":[{"id":"fc3f5aad-0457-4b8f-af11-ba03126537db","name":"Order successfully completed.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/status?token=your_token&order_id=order_id","protocol":"https","host":["api","refee","bot"],"path":["status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"order_id","value":"order_id","description":"(Required) Order ID."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Status order\",\n  \"ip\": \"1.1.1.1\",\n  \"order_id\": 4708742,\n  \"target\": \"TTve1fBTbswndPq99iREv72tkLZ6mBSgJH\",\n  \"duration\": \"1h\",\n  \"volume\": 65000,\n  \"summa\": 5.85,\n  \"txid\": \"7b1943d00451814c2ea03d6a1196a301ca10e89dfd53536e34f09bfa9aeed0e7\",\n  \"status\": \"Filled\",\n  \"tm\": 1749672322\n}"},{"id":"f4bea4a6-b436-4999-8991-c5a18be97960","name":"Order is in progress.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/status?token=your_token&order_id=order_id","host":["https://api.refee.bot"],"path":["status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"order_id","value":"order_id","description":"(Required) Order ID."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Status order\",\n  \"ip\": \"1.1.1.1\",\n  \"order_id\": 123456,\n  \"status\": \"Pending\"\n}"},{"id":"468de7e4-1695-44a3-93a9-fee5d9219c3c","name":"The order has been canceled.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/status?token=your_token&order_id=order_id","host":["https://api.refee.bot"],"path":["status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"order_id","value":"order_id","description":"(Required) Order ID."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Status order\",\n  \"ip\": \"1.1.1.1\",\n  \"order_id\": 123456,\n  \"status\": \"Canceled\"\n}"},{"id":"b4e669a8-a201-4800-a395-079eb92751f8","name":"Not your order_id","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/status?token=your_token&order_id=order_id","host":["https://api.refee.bot"],"path":["status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"order_id","value":"order_id","description":"(Required) Order ID."}]}},"status":"Not your order_id","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Status order\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"Not your order_id\"\n}"},{"id":"f4ddfa42-f4c3-419f-aec0-897fa6e9cfb5","name":"Authentication error. No User by token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/status?token=your_token&order_id=order_id","host":["https://api.refee.bot"],"path":["status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"order_id","value":"order_id","description":"(Required) Order ID."}]}},"status":"Error: No User by token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Status order\",\n  \"ip\": \"1.1.1.1\",\n  \"err\": \"No User by token : Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\"\n}"}],"_postman_id":"cdaf4814-5f8a-4fc3-b3db-dc30454b50d3"}],"id":"122be918-4825-4e59-b56c-7921c92deda2","_postman_id":"122be918-4825-4e59-b56c-7921c92deda2","description":""},{"name":"aml_order","item":[{"name":"Create AML order","id":"10c9c81a-15df-4636-8b60-4865f4a03ece","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/aml_order?token=your_token&target=address&network=BTC&order_type=AML1&request_type=address","description":"<p>The request initiates an AML check for the specified address or transaction.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/aml_order?token=your_token&amp;target=your_target&amp;network=TRX&amp;order_type=AML1&amp;request_type=address</code></p>\n<p><strong>Limitations:</strong></p>\n<ul>\n<li>The AML check is performed only on the Tron, Ethereum, and Bitcoin networks.</li>\n</ul>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Target address or transaction hash</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>network</code></td>\n<td>string</td>\n<td>Network in which the verification will be performed.  <br />Allowed values: TRX – Tron, ETH – Ethereum, BTC – Bitcoin.</td>\n<td><strong>TRX</strong></td>\n</tr>\n<tr>\n<td><code>order_type</code></td>\n<td>string</td>\n<td>Order type. Allowed value - <strong>AML1</strong>.</td>\n<td><strong>AML1</strong></td>\n</tr>\n<tr>\n<td><code>request_type</code></td>\n<td>string</td>\n<td>Type of verification — by address or transaction hash.  <br />Allowed values: <strong>address</strong> – address, <strong>transaction</strong> – transaction hash.</td>\n<td><strong>address</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>uid</code></td>\n<td>number</td>\n<td>ID of the completed AML order</td>\n<td><strong>15421</strong></td>\n</tr>\n<tr>\n<td><code>order_type</code></td>\n<td>string</td>\n<td>Order type</td>\n<td><strong>AML1</strong></td>\n</tr>\n<tr>\n<td><code>request_type</code></td>\n<td>string</td>\n<td>Request type - by address or transaction hash</td>\n<td><strong>address</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Target address or transaction hash</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>network</code></td>\n<td>string</td>\n<td>Network in which the AML check was performed</td>\n<td><strong>TRX</strong></td>\n</tr>\n<tr>\n<td><code>risk_score</code></td>\n<td>number</td>\n<td>Risk assessment value in percent</td>\n<td><strong>0</strong></td>\n</tr>\n<tr>\n<td><code>risk_level</code></td>\n<td>string</td>\n<td>Risk level. Possible values:  <br /><strong>low, medium, high.</strong></td>\n<td><strong>low</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Cost of the AML order (in the native token)</td>\n<td><strong>1.7</strong></td>\n</tr>\n<tr>\n<td><code>report_status</code></td>\n<td>string</td>\n<td>AML order status</td>\n<td><strong>waiting</strong></td>\n</tr>\n<tr>\n<td><code>tm</code></td>\n<td>number</td>\n<td>Report creation timestamp</td>\n<td><strong>1749564600</strong></td>\n</tr>\n<tr>\n<td><code>created_at</code></td>\n<td>string</td>\n<td>Report creation time</td>\n<td><strong>10-06-2025 14:10:00</strong></td>\n</tr>\n<tr>\n<td><code>pdf_link</code></td>\n<td>string</td>\n<td>Link to the report in PDF format</td>\n<td><strong>https://....pdf</strong></td>\n</tr>\n<tr>\n<td><code>exposure</code></td>\n<td>array</td>\n<td>An array containing risk level values and their percentage distribution</td>\n<td><strong>\"exchange\": 78.83,  <br />\"dex\": 9.79,  <br />\"dust\": 8.36,  <br />\"gambling\": 0.74,  <br />\"sanctions\": 0.71...</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>Current user balance (in the native token)</td>\n<td><strong>20.5</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If any parameter in the request body is specified incorrectly, a <strong>403 response</strong> will be returned, indicating the incorrectly provided parameter:</p>\n<h5 id=\"403-response-forbidden-validation-or-authentication-error\"><strong>403 Response (Forbidden). Validation or authentication error.</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>detail</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>Classify error target: type = address, networks = ['TRX']</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["aml_order"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Target address or transaction hash.</p>\n","type":"text/plain"},"key":"target","value":"address"},{"description":{"content":"<p>(Required) Network type. Allowed values - TRX, ETH, BTC.</p>\n","type":"text/plain"},"key":"network","value":"BTC"},{"description":{"content":"<p>(Required) Order type. Allowed value - AML1.</p>\n","type":"text/plain"},"key":"order_type","value":"AML1"},{"description":{"content":"<p>(Required) Type of request. Allowed values - address, transaction.</p>\n","type":"text/plain"},"key":"request_type","value":"address"}],"variable":[]}},"response":[{"id":"e102c5a5-97f1-4ae2-a393-3004c6fa0325","name":"AML order successfully created.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_order?token=your_token&target=address&network=BTC&order_type=AML1&request_type=address","protocol":"https","host":["api","refee","bot"],"path":["aml_order"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"address","description":"(Required) Target address or transaction hash."},{"key":"network","value":"BTC","description":"(Required) Network type. Allowed values - TRX, ETH, BTC."},{"key":"order_type","value":"AML1","description":"(Required) Order type. Allowed value - AML1."},{"key":"request_type","value":"address","description":"(Required) Type of request. Allowed values - address, transaction."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"request\": {\n    \"token\": \"Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK\",\n    \"target\": \"TXjBSgunreusP7q5yCvbGoeAVEJL1qjChd\",\n    \"network\": \"TRX\",\n    \"order_type\": \"AML1\",\n    \"request_type\": \"address\"\n  },\n  \"data\": {\n    \"uid\": 111111,\n    \"order_type\": \"AML1\",\n    \"request_type\": \"address\",\n    \"target\": \"TXjBSgunreusP7q5yCvbGoeAVEJL1qjChd\",\n    \"network\": \"TRX\",\n    \"risk_score\": 0,\n    \"risk_level\": null,\n    \"summa\": 1.85,\n    \"report_status\": \"waiting\",\n    \"tm\": 1749564600,\n    \"created_at\": \"10-06-2025 14:10:00\",\n    \"pdf_link\": \"https://....pdf\",\n    \"exposure\": {}\n  },\n  \"balance\": 128.33190500000003\n}"},{"id":"59a531c3-3b02-4a7c-8d1d-38228fd90501","name":"Forbidden. Invalid API token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_order?token=your_token&target=address&network=BTC&order_type=AML1&request_type=address","host":["https://api.refee.bot"],"path":["aml_order"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"address","description":"(Required) Target address or transaction hash."},{"key":"network","value":"BTC","description":"(Required) Network type. Allowed values - TRX, ETH, BTC."},{"key":"order_type","value":"AML1","description":"(Required) Order type. Allowed value - AML1."},{"key":"request_type","value":"address","description":"(Required) Type of request. Allowed values - address, transaction."}]}},"status":"Forbidden. Invalid API token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Invalid API token\"\n}"},{"id":"ab61ff80-234e-4d95-9e34-24b53906453c","name":"Forbidden. Can't classify target with network","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_order?token=your_token&target=address&network=BTC&order_type=AML1&request_type=address","host":["https://api.refee.bot"],"path":["aml_order"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"address","description":"(Required) Target address or transaction hash."},{"key":"network","value":"BTC","description":"(Required) Network type. Allowed values - TRX, ETH, BTC."},{"key":"order_type","value":"AML1","description":"(Required) Order type. Allowed value - AML1."},{"key":"request_type","value":"address","description":"(Required) Type of request. Allowed values - address, transaction."}]}},"status":"Forbidden. Can't classify target with network","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Can't classify target with network\"\n}"},{"id":"85b83475-cded-4ba8-8a14-108450290943","name":"Forbidden. Classify error target","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_order?token=your_token&target=address&network=BTC&order_type=AML1&request_type=address","host":["https://api.refee.bot"],"path":["aml_order"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"address","description":"(Required) Target address or transaction hash."},{"key":"network","value":"BTC","description":"(Required) Network type. Allowed values - TRX, ETH, BTC."},{"key":"order_type","value":"AML1","description":"(Required) Order type. Allowed value - AML1."},{"key":"request_type","value":"address","description":"(Required) Type of request. Allowed values - address, transaction."}]}},"status":"Forbidden. Classify error target","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Classify error target: type = address, networks = ['TRX']\"\n}"}],"_postman_id":"10c9c81a-15df-4636-8b60-4865f4a03ece"}],"id":"8bab144a-ebce-473c-858c-20b542840d68","_postman_id":"8bab144a-ebce-473c-858c-20b542840d68","description":""},{"name":"aml_status","item":[{"name":"Get AML order status","id":"85173f6f-2cee-4634-a539-effa6e0f9d01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/aml_status?token=your_token&uid=uid","description":"<p>The request returns the status and result of an AML check by the AML order ID.</p>\n<p>To execute the request, user must provide the a valid authentication token (<code>token</code>) and the AML order ID (<code>uid</code>).</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/aml_status?token=your_token&amp;uid=123456</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>uid</code></td>\n<td>integer</td>\n<td>ID of the completed AML order</td>\n<td><strong>123456</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>uid</code></td>\n<td>number</td>\n<td>ID of the completed AML order</td>\n<td><strong>15421</strong></td>\n</tr>\n<tr>\n<td><code>order_type</code></td>\n<td>string</td>\n<td>Order type</td>\n<td><strong>AML1</strong></td>\n</tr>\n<tr>\n<td><code>request_type</code></td>\n<td>string</td>\n<td>Request type - by address or transaction hash</td>\n<td><strong>address</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Target address or transaction hash</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>network</code></td>\n<td>string</td>\n<td>Network in which the AML check was performed</td>\n<td><strong>TRX</strong></td>\n</tr>\n<tr>\n<td><code>risk_score</code></td>\n<td>number</td>\n<td>Risk assessment value in percent</td>\n<td><strong>0</strong></td>\n</tr>\n<tr>\n<td><code>risk_level</code></td>\n<td>string</td>\n<td>Risk level. Possible values:  <br /><strong>low, medium, high.</strong></td>\n<td><strong>low</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Cost of the AML order (in the native token)</td>\n<td><strong>1.7</strong></td>\n</tr>\n<tr>\n<td><code>report_status</code></td>\n<td>string</td>\n<td>AML order status</td>\n<td><strong>waiting</strong></td>\n</tr>\n<tr>\n<td><code>tm</code></td>\n<td>number</td>\n<td>Report creation timestamp</td>\n<td><strong>1749564600</strong></td>\n</tr>\n<tr>\n<td><code>created_at</code></td>\n<td>string</td>\n<td>Report creation time</td>\n<td><strong>10-06-2025 14:10:00</strong></td>\n</tr>\n<tr>\n<td><code>pdf_link</code></td>\n<td>string</td>\n<td>Link to the report in PDF format</td>\n<td><strong>https://....pdf</strong></td>\n</tr>\n<tr>\n<td><code>exposure</code></td>\n<td>array</td>\n<td>An array containing risk level values and their percentage distribution</td>\n<td><strong>\"exchange\": 78.83,  <br />\"dex\": 9.79,  <br />\"dust\": 8.36,  <br />\"gambling\": 0.74,  <br />\"sanctions\": 0.71...</strong></td>\n</tr>\n<tr>\n<td><code>balance</code></td>\n<td>number</td>\n<td>Current user balance (in the native token)</td>\n<td><strong>20.5</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>If any parameter in the request body is specified incorrectly, a 403 response will be returned, indicating the incorrectly provided parameter:</p>\n<h5 id=\"403-response-forbidden-invalid-token-or-uid\"><strong>403 Response (Forbidden). Invalid token or UID.</strong></h5>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>detail</code></td>\n<td>string</td>\n<td>Error message.  <br />If the <code>token</code> parameter is incorrect – <strong>\"Invalid API token\"</strong>  <br />If the <code>uid</code> parameter is incorrect – <strong>\"Invalid uid\"</strong></td>\n<td><strong>Invalid API token</strong>  <br />  <br /><strong>Invalid uid</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["aml_status"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Order UID.</p>\n","type":"text/plain"},"key":"uid","value":"uid"}],"variable":[]}},"response":[{"id":"60fafb69-bc12-438e-b499-a0d4bb5743c4","name":"AML order status retrieved successfully.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_status?token=your_token&uid=uid","protocol":"https","host":["api","refee","bot"],"path":["aml_status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"uid","value":"uid","description":"(Required) Order UID."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"uid\": 11111,\n    \"order_type\": \"AML1\",\n    \"request_type\": \"address\",\n    \"target\": \"TXjBSgunreusP7q5yCvbGoeAVEJL1qjChd\",\n    \"network\": \"TRX\",\n    \"risk_score\": 0,\n    \"risk_level\": null,\n    \"summa\": 1.72,\n    \"report_status\": \"waiting\",\n    \"tm\": 1749564600,\n    \"created_at\": \"10-06-2025 14:10:00\",\n    \"pdf_link\": \"https://....pdf\",\n    \"exposure\": {}\n  },\n  \"balance\": 130.18190500000003\n}"},{"id":"2e67dd39-07d4-45b6-a93d-e29baacbe4cc","name":"Forbidden. Invalid API token","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_status?token=your_token&uid=uid","protocol":"https","host":["api","refee","bot"],"path":["aml_status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"uid","value":"uid","description":"(Required) Order UID."}]}},"status":"Forbidden. Invalid API token","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Invalid API token\"\n}"},{"id":"c8e1190c-2d16-423f-986e-f301c9eb6917","name":"Forbidden. Invalid UID","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/aml_status?token=your_token&uid=uid","protocol":"https","host":["api","refee","bot"],"path":["aml_status"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"uid","value":"uid","description":"(Required) Order UID."}]}},"status":"Forbidden. Invalid UID","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Invalid uid\"\n}"}],"_postman_id":"85173f6f-2cee-4634-a539-effa6e0f9d01"}],"id":"153dc146-1e28-4389-a2bc-62cf38ce655f","_postman_id":"153dc146-1e28-4389-a2bc-62cf38ce655f","description":""},{"name":"smart_energy","item":[{"name":"Control Smart Energy","id":"61b29b82-9212-40da-9330-a31ce9015e09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/smart_energy?token=your_token&target=TrxAddress&action=start","description":"<p>This request is intended to manage the \"Always Charged\" function for a specified address.</p>\n<p>Supported actions:</p>\n<ul>\n<li><p><code>start</code> – Activate</p>\n</li>\n<li><p><code>stop</code> – Pause</p>\n</li>\n<li><p><code>delete</code> – Remove from the list</p>\n</li>\n</ul>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/smart_energy?token=your_token&amp;target=TrxAddress&amp;action=start</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>action</code></td>\n<td>string</td>\n<td>Required action.  <br />Allowed values:  <br /><strong>start</strong> – Activate  <br /><strong>stop</strong> – Pause  <br /><strong>delete</strong> – Remove from the list</td>\n<td><strong>start</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>is_active</code></td>\n<td>boolean</td>\n<td>Indicates whether the \"Always Charged\" mode is active for the address.  <br />Possible values:  <br /><strong>true</strong> – \"Always Charged\" mode is active;  <br /><strong>false</strong> – \"Always Charged\" mode is paused.</td>\n<td><strong>true/false</strong></td>\n</tr>\n<tr>\n<td><code>is_deleted</code></td>\n<td>boolean</td>\n<td>Indicates whether the specified address has been removed from the list.  <br />Possible values:  <br /><strong>true</strong> – the address has been removed;  <br /><strong>false</strong> – the address is still in the list.</td>\n<td><strong>true/false</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"403-response-forbidden-user-not-foundnot-found-tagret-for-startstop-or-delete-it\"><strong>403 Response (Forbidden). User not found/Not found tagret for start/stop or delete it</strong></h5>\n<p>If the <code>token</code> or <code>target</code> parameters are specified incorrectly, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message:  <br />If the <code>token</code> is incorrect – <strong>\"User not found\"</strong>;  <br />If the <code>target</code> is incorrect – <strong>\"Not found target for start/stop or delete it\"</strong>.</td>\n<td><strong>\"User not found\"</strong>  <br />  <br /><strong>\"Not found tagret for start/stop or delete it\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["smart_energy"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>(Required) Target address (TRC-20).</p>\n","type":"text/plain"},"key":"target","value":"TrxAddress"},{"description":{"content":"<p>(Required) Action needed. Allowed values - start, stop, delete.</p>\n","type":"text/plain"},"key":"action","value":"start"}],"variable":[]}},"response":[{"id":"eb3e109d-0d45-41a0-8479-dd8d76c8c568","name":"Successful response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_energy?token=your_token&target=TrxAddress&action=start","host":["https://api.refee.bot"],"path":["smart_energy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Target address (TRC-20)."},{"key":"action","value":"start","description":"(Required) Action needed. Allowed values - start, stop, delete."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n  \"is_active\": true,\n  \"is_deleted\": false\n}"},{"id":"183e3e8f-c8b7-4a0f-a100-2e68d6397ac2","name":"Forbidden - User not found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_energy?token=your_token&target=TrxAddress&action=start","host":["https://api.refee.bot"],"path":["smart_energy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Target address (TRC-20)."},{"key":"action","value":"start","description":"(Required) Action needed. Allowed values - start, stop, delete."}]}},"status":"Forbidden - User not found","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"err\": \"User not found\"\n}"},{"id":"80ba2820-75c6-4c29-9e40-3ef3e50137d8","name":"Forbidden - Not found tagret for stop or delete it","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_energy?token=your_token&target=TrxAddress&action=start","host":["https://api.refee.bot"],"path":["smart_energy"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"target","value":"TrxAddress","description":"(Required) Target address (TRC-20)."},{"key":"action","value":"start","description":"(Required) Action needed. Allowed values - start, stop, delete."}]}},"status":"Forbidden - Not found tagret for stop or delete it","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"err\": \"Not found tagret for stop or delete it\"\n}"}],"_postman_id":"61b29b82-9212-40da-9330-a31ce9015e09"}],"id":"62b038f2-5e8a-466f-a8ec-8d11233bd153","_postman_id":"62b038f2-5e8a-466f-a8ec-8d11233bd153","description":""},{"name":"smart_logs","item":[{"name":"Get Always Charged Action Logs","id":"b0dcdcaf-f880-4ac6-80fc-170bfadfe3b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/smart_logs?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","description":"<p>This request returns a paginated list of \"Always Charged\" actions for the authenticated user.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/smart_logs?token=your_token&amp;from_tm=1717000000&amp;till_tm=1717499999&amp;target=target&amp;limit=20&amp;pg=1</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>from_tm</code></td>\n<td>integer</td>\n<td>Start of time range (Unix timestamp). Defaults to 0 if not provided.</td>\n<td><strong>1717000000</strong></td>\n</tr>\n<tr>\n<td><code>till_tm</code></td>\n<td>integer</td>\n<td>End of time range (Unix timestamp). Defaults to current time if not provided.</td>\n<td><strong>1717499999</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format or ID</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>limit</code></td>\n<td>integer</td>\n<td>Maximum number of items per page (max 100).</td>\n<td><strong>20</strong></td>\n</tr>\n<tr>\n<td><code>pg</code></td>\n<td>integer</td>\n<td>Page number (pagination).</td>\n<td><strong>1</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>page</code></td>\n<td>integer</td>\n<td>Page number</td>\n<td><strong>1</strong></td>\n</tr>\n<tr>\n<td><code>limit</code></td>\n<td>integer</td>\n<td>Maximum number of items per page</td>\n<td><strong>20</strong></td>\n</tr>\n<tr>\n<td><code>total</code></td>\n<td>integer</td>\n<td>Total number of items</td>\n<td><strong>42</strong></td>\n</tr>\n<tr>\n<td><code>id</code></td>\n<td>integer</td>\n<td>Request ID</td>\n<td><strong>1</strong></td>\n</tr>\n<tr>\n<td><code>user</code></td>\n<td>integer</td>\n<td>User ID</td>\n<td><strong>123</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format or ID</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>\"Always charged\" function status</td>\n<td><strong>start</strong></td>\n</tr>\n<tr>\n<td><code>tm</code></td>\n<td>integer</td>\n<td>Time of request (Unix timestamp)</td>\n<td><strong>1717460000</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"403-response-forbidden-invalid-token-or-user-not-found\"><strong>403 Response (Forbidden).</strong> Invalid token or user not found</h5>\n<p>If the <code>token</code> parameter is specified incorrectly, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>detail</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>\"Invalid token or user not found\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["smart_logs"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>Start of time range (Unix timestamp). Defaults to 0 if not provided.</p>\n","type":"text/plain"},"key":"from_tm","value":"1717000000"},{"description":{"content":"<p>End of time range (Unix timestamp). Defaults to current time if not provided.</p>\n","type":"text/plain"},"key":"till_tm","value":"1717499999"},{"description":{"content":"<p>Filter actions by target address or identifier.</p>\n","type":"text/plain"},"key":"target","value":"target"},{"description":{"content":"<p>Maximum number of items per page (max 100).</p>\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"<p>Page number (pagination) (min 1).</p>\n","type":"text/plain"},"key":"pg","value":"1"}],"variable":[]}},"response":[{"id":"5a843d3c-8020-4ee3-a349-717f0cbc075c","name":"Successful response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_logs?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","host":["https://api.refee.bot"],"path":["smart_logs"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"from_tm","value":"1717000000","description":"Start of time range (Unix timestamp). Defaults to 0 if not provided."},{"key":"till_tm","value":"1717499999","description":"End of time range (Unix timestamp). Defaults to current time if not provided."},{"key":"target","value":"target","description":"Filter actions by target address or identifier."},{"key":"limit","value":"20","description":"Maximum number of items per page (max 100)."},{"key":"pg","value":"1","description":"Page number (pagination) (min 1)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"page\": 1,\n  \"limit\": 20,\n  \"total\": 42,\n  \"items\": [\n    {\n      \"id\": 1,\n      \"user\": 123,\n      \"target\": \"TGxxxxx\",\n      \"status\": \"start\",\n      \"tm\": 1717460000\n    }\n  ]\n}"},{"id":"9adb4275-ffe1-46cb-907b-5f44b9919c70","name":"Forbidden - Invalid token or user not found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_logs?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","host":["https://api.refee.bot"],"path":["smart_logs"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"from_tm","value":"1717000000","description":"Start of time range (Unix timestamp). Defaults to 0 if not provided."},{"key":"till_tm","value":"1717499999","description":"End of time range (Unix timestamp). Defaults to current time if not provided."},{"key":"target","value":"target","description":"Filter actions by target address or identifier."},{"key":"limit","value":"20","description":"Maximum number of items per page (max 100)."},{"key":"pg","value":"1","description":"Page number (pagination) (min 1)."}]}},"status":"Forbidden - Invalid token or user not found","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Invalid token or user not found\"\n}"}],"_postman_id":"b0dcdcaf-f880-4ac6-80fc-170bfadfe3b8"}],"id":"89783be8-36c0-4201-83a8-bd85f0765345","_postman_id":"89783be8-36c0-4201-83a8-bd85f0765345","description":""},{"name":"smart_orders","item":[{"name":"Get Always Charged Orders","id":"f8875c8d-c096-45f8-9943-a9cb128453b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/smart_orders?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","description":"<p>This request returns a paginated list of \"Always Charged\" orders for the authenticated user.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/smart_orders?token=your_token&amp;from_tm=1717000000&amp;till_tm=1717499999&amp;target=target&amp;limit=20&amp;pg=1</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n<tr>\n<td><code>from_tm</code></td>\n<td>integer</td>\n<td>Start of time range (Unix timestamp). Defaults to 0 if not provided.</td>\n<td><strong>1717000000</strong></td>\n</tr>\n<tr>\n<td><code>till_tm</code></td>\n<td>integer</td>\n<td>End of time range (Unix timestamp). Defaults to current time if not provided.</td>\n<td><strong>1717499999</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format or ID</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>limit</code></td>\n<td>integer</td>\n<td>Maximum number of items per page (max 100).</td>\n<td><strong>20</strong></td>\n</tr>\n<tr>\n<td><code>pg</code></td>\n<td>integer</td>\n<td>Page number (pagination).</td>\n<td><strong>1</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>page</code></td>\n<td>integer</td>\n<td>Page number</td>\n<td><strong>1</strong></td>\n</tr>\n<tr>\n<td><code>limit</code></td>\n<td>integer</td>\n<td>Maximum number of items per page</td>\n<td><strong>20</strong></td>\n</tr>\n<tr>\n<td><code>total</code></td>\n<td>integer</td>\n<td>Total number of items</td>\n<td><strong>42</strong></td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>integer</td>\n<td>Order ID</td>\n<td><strong>1</strong></td>\n</tr>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format or ID</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>volume</code></td>\n<td>string</td>\n<td>Energy volume for specific order</td>\n<td><strong>65000</strong></td>\n</tr>\n<tr>\n<td><code>summa</code></td>\n<td>number</td>\n<td>Cost of the order</td>\n<td><strong>5.5</strong></td>\n</tr>\n<tr>\n<td><code>tm</code></td>\n<td>integer</td>\n<td>Time of request (Unix timestamp)</td>\n<td><strong>1717460000</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"403-response-forbidden-invalid-token-or-user-not-found\"><strong>403 Response (Forbidden).</strong> Invalid token or user not found</h5>\n<p>If the <code>token</code> parameter is specified incorrectly, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>detail</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>\"Invalid token or user not found\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["smart_orders"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"},{"description":{"content":"<p>Start of time range (Unix timestamp). Defaults to 0 if not provided.</p>\n","type":"text/plain"},"key":"from_tm","value":"1717000000"},{"description":{"content":"<p>End of time range (Unix timestamp). Defaults to current time if not provided.</p>\n","type":"text/plain"},"key":"till_tm","value":"1717499999"},{"description":{"content":"<p>Filter actions by target address or identifier.</p>\n","type":"text/plain"},"key":"target","value":"target"},{"description":{"content":"<p>Maximum number of items per page (max 100).</p>\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"<p>Page number (pagination) (min 1).</p>\n","type":"text/plain"},"key":"pg","value":"1"}],"variable":[]}},"response":[{"id":"c7e8ced2-dfac-4020-890f-c84b738ac0bf","name":"Successful response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_orders?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","host":["https://api.refee.bot"],"path":["smart_orders"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"from_tm","value":"1717000000","description":"Start of time range (Unix timestamp). Defaults to 0 if not provided."},{"key":"till_tm","value":"1717499999","description":"End of time range (Unix timestamp). Defaults to current time if not provided."},{"key":"target","value":"target","description":"Filter actions by target address or identifier."},{"key":"limit","value":"20","description":"Maximum number of items per page (max 100)."},{"key":"pg","value":"1","description":"Page number (pagination) (min 1)."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"page\": 1,\n  \"limit\": 20,\n  \"total\": 42,\n  \"items\": [\n    {\n      \"order_id\": 1,\n      \"target\": \"TGxxxxx\",\n      \"volume\": 65000,\n      \"summa\": 5.5,\n      \"tm\": 1717460000\n    }\n  ]\n}"},{"id":"7af373dd-c86b-4b1d-8ad7-8138332eaf30","name":"Forbidden - Invalid token or user not found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_orders?token=your_token&from_tm=1717000000&till_tm=1717499999&target=target&limit=20&pg=1","host":["https://api.refee.bot"],"path":["smart_orders"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."},{"key":"from_tm","value":"1717000000","description":"Start of time range (Unix timestamp). Defaults to 0 if not provided."},{"key":"till_tm","value":"1717499999","description":"End of time range (Unix timestamp). Defaults to current time if not provided."},{"key":"target","value":"target","description":"Filter actions by target address or identifier."},{"key":"limit","value":"20","description":"Maximum number of items per page (max 100)."},{"key":"pg","value":"1","description":"Page number (pagination) (min 1)."}]}},"status":"Forbidden - Invalid token or user not found","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"detail\": \"Invalid token or user not found\"\n}"}],"_postman_id":"f8875c8d-c096-45f8-9943-a9cb128453b7"}],"id":"df616a02-9989-4c47-9ffd-ac5d149fed2e","_postman_id":"df616a02-9989-4c47-9ffd-ac5d149fed2e","description":""},{"name":"smart_list","item":[{"name":"Get Smart Energy List","id":"b720e6b9-fc9a-4ffd-8f6f-326a26484ed1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.refee.bot/smart_list?token=your_token","description":"<p>This request is used to retrieve the list of addresses that are included in the \"Always Charged\" mode.</p>\n<p><strong>Request example:</strong> <code>GET https://api.refee.bot/smart_list?token=your_token</code></p>\n<h4 id=\"description-of-request-parameters\">Description of request parameters:</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>token</code></td>\n<td>string</td>\n<td>The user's authentication token. The token must be valid and belong to a registered user.</td>\n<td><strong>Zim0ciN2c1FZTWWrasWTFXTcxf2K00F3dDqmH9dyD9UJzXDDIL7cfGQRVNFqnKhK</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"description-of-response-parameters\">Description of response parameters</h4>\n<h5 id=\"200-response-ок-successful-request\">200 Response (ОК): Successful request.</h5>\n<p>If the request is successfully completed, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>target</code></td>\n<td>string</td>\n<td>Address in TRC-20 format</td>\n<td><strong>TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf</strong></td>\n</tr>\n<tr>\n<td><code>is_active</code></td>\n<td>boolean</td>\n<td>Indicates whether the \"Always Charged\" option is active for the address.  <br />Possible values:  <br /><strong>true</strong> – \"Always Charged\" mode is active;  <br /><strong>false</strong> – \"Always Charged\" mode is paused.</td>\n<td><strong>true/false</strong></td>\n</tr>\n</tbody>\n</table>\n</div><h5 id=\"403-response-forbidden-user-not-found\"><strong>403 Response (Forbidden). User not found</strong></h5>\n<p>If the <code>token</code> parameter is specified incorrectly, the response will contain the following information:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Параметр</strong></th>\n<th><strong>Тип</strong></th>\n<th><strong>Описание</strong></th>\n<th><strong>Пример</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>err</code></td>\n<td>string</td>\n<td>Error message</td>\n<td><strong>\"User not found\"</strong></td>\n</tr>\n</tbody>\n</table>\n</div><p>Examples of <strong>200</strong> and <strong>403</strong> responses are shown in the Example Request panel. To select the response type, use the dropdown menu.</p>\n","urlObject":{"path":["smart_list"],"host":["https://api.refee.bot"],"query":[{"description":{"content":"<p>(Required) The user's authentication token. The token must be valid and belong to a registered user.</p>\n","type":"text/plain"},"key":"token","value":"your_token"}],"variable":[]}},"response":[{"id":"9deab5eb-0312-4b51-9b41-b76a55fea10d","name":"List of smart energy targets","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_list?token=your_token","protocol":"https","host":["api","refee","bot"],"path":["smart_list"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n  {\n    \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n    \"is_active\": false\n  },\n  {\n    \"target\": \"TMJL4BYjcM3thqzd9HjHkA53DaceR6qpFf\",\n    \"is_active\": false\n  }\n]"},{"id":"c68cbc4e-c4dd-4865-af10-2b74a6d6fedd","name":"Forbidden - User not found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.refee.bot/smart_list?token=your_token","host":["https://api.refee.bot"],"path":["smart_list"],"query":[{"key":"token","value":"your_token","description":"(Required) The user's authentication token. The token must be valid and belong to a registered user."}]}},"status":"Forbidden - User not found","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"err\": \"User not found\"\n}"}],"_postman_id":"b720e6b9-fc9a-4ffd-8f6f-326a26484ed1"}],"id":"57676744-8622-4a5d-9367-60e24627233b","_postman_id":"57676744-8622-4a5d-9367-60e24627233b","description":""}],"variable":[{"key":"baseUrl","value":"https://api.refee.bot"}]}