购买能源

要使用此功能，您必须拥有API密钥。请在此处了解如何获取我们的API密钥

TronSave 使用API密钥购买

通过API密钥创建新的购买能源订单

POST https://api.tronsave.io/v0/internal-buy-energy

通过API密钥创建新的购买能源订单

速率限制 (Rate limit): 每2秒1个请求。

Headers

Name	Type	Description
apikey*	String	Tronsave API密钥，用于内部帐户。

Request Body

Name	Type	Description
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	如果这个值为真，则订单可以从多个委托者那里填充。如果这个值为假，订单将填充困难一些。能源数量大于200,000的订单可以设置这个参数。
target_address*	String	接收资源的地址
duration_millisec	Number	订单持续时间（毫秒）。默认值：259200000（3天）。

200: OK 成功 (Success)

如果成功，返回订单ID。

{
    "order_id": "new_order_id"
}

400: Bad Request 无效的参数 (Invalid params)

{
"MISSING_PARAMS": "在请求体中缺少一些参数",
"INVALID_PARAMS": "一些参数无效",
"ORDER_BUY_ENERGY_AMOUNT_TOO_SMALL": "订单金额太小，不得少于40000",
"CANNOT_SET_PARTIAL_FULFILLED": "订单金额小于100000时无法设置部分完成",
"INTERNAL_ACCOUNT_NOT_FOUND": "内部帐户不存在",
"ORDER_BUY_ENERGY_CAN_NOT_CREATE": "创建订单时出现错误，无法创建，请稍后再试",
"INTERNAL_BALANCE_ACCOUNT_TOO_LOW": "余额不足"
}

401: Unauthorized 无效的API密钥 (Invalid API key)

{
"API_KEY_REQUIRED": "请求头中缺少API密钥",
"INVALID_API_KEY": "API密钥不正确"
}

429: Too Many Requests 已达到速率限制 (Rate limit reached)

{
"RATE_LIMIT": "已达到速率限制"
}

例子 (Example)

Body

{
    "resource_type": "ENERGY",
    "buy_energy_type": "FAST",
    "amount": 100000,
    "allow_partial_fill": true,
    "target_address": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
    "duration_millisec":86400000
}

Headers

{
  "apikey": <YOUR_API_KEY>
}

Success Response

{
      "order_id": "651d2306e55c073f6ca0992e",
      "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
      "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
      "resource_amount": 100000,
      "resource_type": "ENERGY",
      "remain_amount": 0,
      "price": 67.5,
      "duration": 3600,
      "allow_partial_fill": true,
      "payout_amount": 6750000,
      "fulfilled_percent": 100
}