Create order

Create order

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

Rate limit: 15 requests per 1 second

Request params

Field	Type	Required	Description
resource_type	string	true	"ENERGY"
unit_price	number	true	Price unit is equal to sun.
allow_partial_fill	boolean	true	Allow the order to be filled partially or not
target_address	string	true	Resource receiving address
duration_millisec	number	true	The duration of the bought resource, time unit is equal to millisec.
tx_id	string	true	Transaction ID
signed_tx	SignedTransaction	true	Signed transaction, Note that it is a json object (signed_tx in Step 2)
only_create_when_fulfilled	Boolean	false	[true]=> order only create when it can be fulfilled [false] => order will create even it can not be fulfilled Default value: false
max_price_accepted	Number	false	Only create order when the estimate price less than this value.
add_order_incomplete	Boolean	false	[true]=> order only create when there has no same parameters order is not complete in order list [false] => order will create even there has no same parameters order is not complete in order list Default value: false

Request params example

{
    "resource_type": "ENERGY",
    "unit_price": 45,
    "allow_partial_fill": true,
    "target_address": "TM6ZeEgpefyGWeMLuzSbfqTGkPv8Z6Jm4X",
    "duration_millisec": 259200000,
    "tx_id": "446eed36e31249b98b201db2e81a3825b185f1a3d8b2fea348b24fc021e58e0d",
    "signed_tx": {
      "visible": false,
      "txID": "446eed36e31249b98b201db2e81a3825b185f1a3d8b2fea348b24fc021e58e0d",
      "raw_data": {
        "contract": [
          {
            "parameter": {
              "value": {
                "amount": 13500000,
                "owner_address": "417a0d868d1418c9038584af1252f85d486502eec0",
                "to_address": "41055756f33f419278d9ea059bd2b21120e6add748"
              },
              "type_url": "type.googleapis.com/protocol.TransferContract"
            },
            "type": "TransferContract"
          }
        ],
        "ref_block_bytes": "0713",
        "ref_block_hash": "6c5f7686f4176139",
        "expiration": 1691465106000,
        "timestamp": 1691465046758
      },
      "raw_data_hex": "0a02071322086c5f7686f417613940d084b5999d315a68080112640a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412330a15417a0d868d1418c9038584af1252f85d486502eec0121541055756f33f419278d9ea059bd2b21120e6add74818e0fcb70670e6b5b1999d31",
      "signature": ["xxxxxxxxx"]
    },
    "only_create_when_fulfilled":false,
    "max_price_accepted":200,
    "add_order_incomplete":false
}

Responses

{
    "message": "651d2306e55c073f6ca0992e" //order_id
}