Create order

Create order

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

Request params

Field
Position
Type
Required
Description

resource_type

body

string

true

"ENERGY"

unit_price

body

number

true

Price unit is equal to sun.

allow_partial_fill

body

boolean

true

Allow the order to be filled partially or not

target_address

body

string

true

Resource receiving address

duration_millisec

body

number

true

The duration of the bought resource, time unit is equal to millisec.

tx_id

body

string

true

Transaction ID

signed_tx

body

SignedTransaction

true

Signed transaction, Note that it is a json object (signed_tx in Step 2)

only_create_when_fulfilled

body

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

body

Number

false

Only create order when the estimate price less than this value.

add_order_incomplete

body

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
}

Last updated