API docs by Redocly

TRXFEE.iO API Documentation - 接口文档 (1.0.0)

Download OpenAPI specification:

购买/租用波场能量API文档

回调说明

系统通过 HTTP POST 请求向配置的回调地址发送订单状态变更通知。

通用请求格式

HTTP方法: POST

Content-Type: application/json

请求头:

  • Accept: /
  • Content-Type: application/json

请求体:

{
  "energy_amount": "number",    // 能量数量
  "out_trade_no": "string",     // 外部订单号 
  "serial": "string",           // 内部订单号
  "txid": "string",             // 哈希
  "status": "string",           // 订单状态('0'失败，'1'成功，'2'退款) 
  "refund": "number",           // 退款金额
  "type": "string",             // 资源类型('energy')
  "receive_address": "string",  // 接收地址
  "source": "string"            // 订单来源('api'API，'swap'闪兑，'times'笔数)
}

响应要求

  • 成功: 返回 200 状态码

重试策略

失败后重试间隔: 30s

最大重试次数: 8次

下单

通过TRXFEE.iO官方接口使用秘钥下单

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

TIMESTAMP
required
string

时间戳

SIGNATURE
required
string

签名

Content-Type
required
string
Default: application/json

媒体类型

Request Body schema: aplication/json
required
energy_amount
integer

能量数量

period
string

租赁时长(暂时只支持1小时)

receive_address
TRON地址

接收地址(仅作为示例，请勿向该地址转账！)

callback_url
string

回调地址

out_trade_no
string

外部订单号，用户自己的订单号

auto_activation
boolean

是否自动激活未激活地址(自动激活下单速度会比正常下单慢一点)

Responses

Request samples

Content type
aplication/json
{
  • "energy_amount": 65000,
  • "period": "1H",
  • "receive_address": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp",
  • "callback_url": "https://mydomain.com/callback",
  • "out_trade_no": "OTN202501010001",
  • "auto_activation": true
}

Response samples

Content type
application/json
Example
{
  • "error": 0,
  • "amount": 2.085,
  • "balance": 97.915,
  • "ordersNum": "EO250101000001",
  • "activationOrdersNum": "EO250101000001",
  • "activationHoldAmount": 1.1
}

激活地址

通过TRXFEE.iO官方接口使用秘钥激活地址

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

TIMESTAMP
required
string

时间戳

SIGNATURE
required
string

签名

Content-Type
required
string
Default: application/json

媒体类型

Request Body schema: aplication/json
required
receive_address
TRON地址

接收地址(仅作为示例，请勿向该地址转账！)

Responses

Request samples

Content type
aplication/json
{
  • "receive_address": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp"
}

Response samples

Content type
application/json
{
  • "error": 0,
  • "amount": 2.085,
  • "balance": 97.915,
  • "ordersNum": "EO250101000001"
}

查询账号信息

用于查询TRXFEE.iO平台上的账号信息

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/account"

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "data": {
    }
}

查询api信息

用于查询TRXFEE.iO平台上的api信息

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/apiInfo"

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "data": {
    }
}

查询订单预估价格

用于查询TRXFEE.iO平台上个人订单预估价格

query Parameters
energy
required
integer
Example: energy=65000

能量数量

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/estimate"

querystring = {"energy":"65000"}

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "data": 2.085
}

查询订单信息

用于查询TRXFEE.iO平台上个人的订单信息

path Parameters
ordersNum
required
string
Example: EO250101000001

下单时返回的平台订单编号

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/order/EO250101000001"

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "data": {
    }
}

笔数托管下单

通过TRXFEE.iO官方接口使用秘钥下单笔数托管

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

TIMESTAMP
required
string

时间戳

SIGNATURE
required
string

签名

Content-Type
required
string
Default: application/json

媒体类型

Request Body schema: aplication/json
required
rentTimes
integer

租用次数(最少5次，0为永续)

recvAddr
TRON地址

接收地址(仅作为示例，请勿向该地址转账！)

freePause
integer

空闲暂停天数(为空时不暂停)

resourceReplenish
string

资源补充(带宽/TRX)——"0"为不补充；"1"为补充

Responses

Request samples

Content type
aplication/json
{
  • "rentTimes": 5,
  • "recvAddr": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp",
  • "freePause": 2,
  • "resourceReplenish": 1
}

Response samples

Content type
application/json
Example
{
  • "error": 0,
  • "recvAddr": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp",
  • "msg": "添加笔数订单成功"
}

查询笔数订单预估价格

用于查询TRXFEE.iO平台上智能笔数价格

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/timesOrderPrice"

querystring = {}

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "oneDeal": 2.75,
  • "twoDeal": 5.5,
  • "bandwidth": 0.6
}

查询地址笔数订单信息

用于查询TRXFEE.iO平台上个人的笔数信息

path Parameters
address
required
string
Example: TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp

接收地址(仅作为示例，请勿向该地址转账！)

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

Responses

Request samples 

import requests

url = "https://trxfee.io/v1/timesOrder/TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp"

headers = {"API-KEY": "你的APIKEY"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Response samples

Content type
application/json
{
  • "msg": "操作成功",
  • "code": 200,
  • "data": [
    ]
}

启用/禁用笔数托管

通过TRXFEE.iO官方接口使用秘钥下单启用/禁用笔数托管

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

TIMESTAMP
required
string

时间戳

SIGNATURE
required
string

签名

Content-Type
required
string
Default: application/json

媒体类型

Request Body schema: aplication/json
required
recvAddr
TRON地址

接收地址(仅作为示例，请勿向该地址转账！)

Responses

Request samples

Content type
aplication/json
{
  • "recvAddr": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp"
}

Response samples

Content type
application/json
Example
{
  • "error": 0,
  • "address": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp",
  • "msg": "笔数订单已暂停/笔数订单已暂停启用"
}

修改笔数租用次数

通过TRXFEE.iO官方接口使用秘钥修改笔数租用次数

header Parameters
API-KEY
required
string

用户于 API 页面中创建的APIKEY

TIMESTAMP
required
string

时间戳

SIGNATURE
required
string

签名

Content-Type
required
string
Default: application/json

媒体类型

Request Body schema: aplication/json
required
recvAddr
TRON地址

接收地址(仅作为示例，请勿向该地址转账！)

rentTimes
integer

租用次数(正整数或负整数,该值不是将租用次数设置为参数值,而是笔数当前租用次数 + 参数)

Responses

Request samples

Content type
aplication/json
{
  • "recvAddr": "TVLfrFDKYStBTPMf3urus7RB4aMDXKzeDp",
  • "rentTimes": 3
}

Response samples

Content type
application/json
{
  • "msg": "笔数订单租用次数修改成功,当前次数为: 5",
  • "code": 200,
  • "error": 0
}