创建订单

要使用此功能，您必须拥有 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天）。

sponsor

String

赞助商代码

only_create_when_fulfilled

Boolean

[true] => 订单只有在能够完成时才会创建 [false] => 即使订单无法完成也会创建 默认值: false

max_price_accepted

Number

只有当预估价格低于此值时才会创建订单。

add_order_incomplete

Boolean

[true] => 订单只有在订单列表中没有相同参数的未完成订单时才会创建 [false] => 即使订单列表中有相同参数的未完成订单，订单也会创建 默认值: false

如果成功，返回订单ID。

{ 
    "order_id": string,
    "requester": string, // 表示订单拥有者的地址 
    "target": string, // 接收资源的地址 
    "resource_amount": number, // 资源数量 
    "resource_type": string, // 资源类型是 "ENERGY" 
    "remain_amount": number, // 系统可匹配的剩余数量 
    "price": number, // 价格单位为 sun 
    "duration": number, // 租赁时长，时长单位为秒 
    "allow_partial_fill": boolean, // 是否允许部分完成订单 
    "payout_amount": number, // 该订单的总支付金额 
    "fulfilled_percent": number, // 显示订单完成进度的百分比，0-100 
}

例子 (Example)

{
    "resource_type": "ENERGY",
    "buy_energy_type": "FAST",
    "amount": 100000,
    "allow_partial_fill": true,
    "target_address": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
    "duration_millisec":86400000, //Optional
    "sponsor": <YOUR SPONSOR REF CODE> //Optional
    "only_create_when_fulfilled": false,
    "max_price_accepted": 100,
    "add_order_incomplete": false
}

Example Code

const BuyEnergy = async (api_key, target_address, amount, duration_ms) => {
    const url = `https://api.tronsave.io/v0/internal-buy-energy`
    //see more at https://docs.tronsave.io/buy-energy-on-telegram/using-api-key-to/buy-energy
    const body = {
        "resource_type": "ENERGY",
        "buy_energy_type": "MEDIUM", //price in sun or "SLOW"|"MEDIUM"|"FAST"
        "amount": amount, //Amount of resource want to buy
        "allow_partial_fill": true,
        "target_address": target_address,
        "duration_millisec": duration_ms, //order duration in milli sec. Default: 259200000 (3 days)
        "only_create_when_fulfilled": false,
        "max_price_accepted": 100,
        "add_order_incomplete": false
    }
    const data = await fetch(url, {
        method: "POST",
        headers: {
            'apikey': api_key,
            "content-type": "application/json",
        },
        body: JSON.stringify(body)
    })
    const response = await data.json()
    /**
     * Example response 
     * @link  https://docs.tronsave.io/buy-energy-on-telegram/using-api-key-to/buy-energy
   {
      "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
}
     */
    return response
}
Previous获取估算 TRX (Estimate TRX)Next获取内部账户信息

Last updated