购买 — API 密钥
用于通过 API 密钥购买能量的旧版 v0 REST 端点——账户信息、订单簿、TRX 预估、创建订单、订单详情、订单历史以及钱包激活。
本页面记录的是 旧版 v0 API。新的集成应使用当前的 API。受支持的端点请参阅 通过 API 密钥购买。下方的 v0 端点对现有集成仍然可用。
本页面上的所有端点都通过在 apikey 请求头中发送的 API 密钥 进行身份验证。该密钥与你的 TronSave 内部账户 绑定,订单从该账户余额中支付。获取密钥请参阅 身份验证。
基础 URL(主网): https://api.tronsave.io
TRON Nile(测试网): 将基础 URL 替换为 https://api-dev.tronsave.io。
预估 TRX:
POSThttps://api-dev.tronsave.io/v0/estimate-trx创建订单:
POSThttps://api-dev.tronsave.io/v0/internal-buy-energy获取内部账户信息:
GEThttps://api-dev.tronsave.io/v0/user-info获取内部账户订单历史:
GEThttps://api-dev.tronsave.io/v0/orders获取单个订单详情:
GEThttps://api-dev.tronsave.io/v0/order/:id获取订单簿:
GEThttps://api-dev.tronsave.io/v0/order-book
下方每个端点的速率限制为每 1 秒 15 次请求。
获取内部账户信息
通过 API 密钥获取账户信息。
GET https://api.tronsave.io/v0/user-info
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
响应
id
string
内部账户 id。
balance
string
内部账户余额,以 SUN 计。
represent_address
string
代表内部账户作为订单的请求方。
deposit_address
string
内部账户的充值地址。
请求示例
获取订单簿
通过 API 密钥获取订单簿。
GET https://api.tronsave.io/v0/order-book
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
查询参数
address
string
能量接收地址。
min_delegate_amount
number
单个供应商代理(委托)的最小能量数量。
duration_sec
number
订单时长,以秒计。
响应
请求示例
预估 TRX
在创建订单之前,预估一笔购买的 TRX 成本。
POST https://api.tronsave.io/v0/estimate-trx
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
请求体
amount
body
number
true
资源数量。
buy_energy_type
body
string, number
true
"FAST"、"MEDIUM"、"SLOW",或一个数字:
- FAST:如果市场可成交比例 = 100%,则 FAST = MEDIUM。如果市场可成交比例 < 100%,则 FAST = MEDIUM + 10。如果市场可成交比例 = 0%,则 FAST = SLOW + 20。
- MEDIUM:为该订单实现最大市场成交量的最低价格。如果市场可成交比例 = 0%,则 MEDIUM = SLOW + 10。
- SLOW:该订单可设置的最低价格。
- 如果价格为数字,则价格单位为 SUN。
duration_millisec
body
number
true
所购资源的时长,以毫秒计。
request_address
body
string
false
请求方的地址。
target_address
body
string
false
资源接收地址。
is_partial
body
boolean
false
是否允许订单被部分成交。
请求体示例
响应
unit_price
number
true
符合你 buy_energy_type 的能量价格,以 SUN 计。
duration_millisec
number
true
时长,以毫秒计。
available_energy
number
true
TronSave 市场上匹配 unit_price 的可用能量总量。
estimate_trx
number
true
在 duration_millisec 时长内,以 unit_price 支付全部 available_energy 的预估 TRX 总额。
请求示例
购买能量(创建订单)
通过 API 密钥创建一个新的购买能量订单。订单从你的内部账户余额中支付。
POST https://api.tronsave.io/v0/internal-buy-energy
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
请求体
resource_type*
String
"ENERGY"。
buy_energy_type*
String
- FAST:如果市场可成交比例 = 100%,则 FAST = MEDIUM。如果市场可成交比例 < 100%,则 FAST = MEDIUM + 10。如果市场可成交比例 = 0%,则 FAST = SLOW + 20。
- MEDIUM:为该订单实现最大市场成交量的最低价格。如果市场可成交比例 = 0%,则 MEDIUM = SLOW + 10。
- SLOW:该订单可设置的最低价格。
- 如果价格为数字,则价格单位为 SUN。
amount*
Number
要购买的资源数量。
allow_partial_fill*
Boolean
如果为 true,订单可由多个代理方(委托方)成交,相比 false 更易于成交。大于 200k 能量的数量可设置此参数。
target_address*
String
接收资源的地址。
duration_millisec
Number
订单时长,以毫秒计。默认值:259200000(3 天)。
sponsor
String
赞助码。
only_create_when_fulfilled
Boolean
true => 仅在订单可被完全成交时才创建。
false => 即使订单无法被成交也会创建。
默认值:false。
max_price_accepted
Number
仅当预估价格低于此值时才创建订单。
add_order_incomplete
Boolean
true => 仅当订单列表中没有相同参数的未完成订单时才创建订单。
false => 即使订单列表中没有相同参数的未完成订单也会创建订单。
默认值:false。
* 必填。
请求体示例
响应
成功时返回订单 id。
请求示例
获取单个订单详情
通过 API 密钥获取单个订单的详情。
GET https://api.tronsave.io/v0/order/:id
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
响应
此端点的规范路径为 GET https://api.tronsave.io/v0/order/:id,其中 :id 为订单 id。将 id 作为路径片段传递(而非查询参数)。下方所有示例均使用此路径。
请求示例
获取内部账户订单历史
按创建时间排序获取多个订单。默认值:返回最新的 10 个订单。
GET https://api.tronsave.io/v0/orders
速率限制:每 1 秒 15 次请求。
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
查询参数
page
Integer
从 0 开始。默认值:0。
pageSize
Integer
默认值:10。
响应
请求示例
激活钱包地址
在激活任何钱包地址之前,你必须先检查其当前的激活状态。只有状态为 0(未激活)的地址才应提交进行激活。
步骤 1 — 检查激活状态
检查一个或多个 TRON 钱包地址的激活状态。
POST https://api.tronsave.io/v0/helper/is-active-address-check
请求体
addresses
array<string>
true
要检查的 TRON 钱包地址列表。
响应
返回一个整数数组,其中每个值对应请求中相同索引位置的地址。
0
未激活
该地址存在但从未被激活。
继续执行步骤 2 进行激活。
1
合约
该地址是一个智能合约。
跳过——不适用激活。
2
已激活
该地址已被激活。
跳过——无需操作。
3
获取失败
无法从网络获取状态。
稍后重试或检查连接。
4
无效地址
地址格式无效。
核实并更正该地址。
筛选结果数组,收集所有对应状态值等于 0 的地址。这些地址将用于 步骤 2。
示例
步骤 2 — 激活钱包
提交一批 未激活 的地址进行激活。此端点会为提供的每个地址创建激活请求。
费用: 每次激活花费 每个地址 1.5 TRX。在调用此端点之前,请确保你的账户有足够的余额。
POST https://api.tronsave.io/v0/helper/multi-active-address
请求头
apikey*
String
代表你内部账户的 TronSave API 密钥。
* 必填。
请求体
仅包含步骤 1 中状态为 0 的地址。
addresses
array<string>
true
要激活的未激活 TRON 地址列表。
响应
message
string
确认消息,指示创建了多少个激活请求。
请求示例
后续步骤
迁移到当前 API:通过 API 密钥购买。
了解 身份验证 以及如何获取 API 密钥。
在下单前查看 订单类型。
Last updated