Create Order V2

TIP

This API only creates orders for fast transactions, and the order can be placed successfully with sufficient energy. If you need to post to the free trade market. please tell us.
If there is sufficient energy, the energy will generally be sent to the receiving address within 3-6 seconds.
The V3 will be launched in December 2024. The difference from V2 is that V3 is cheaper, but the rental time is fixed at 5 minutes. If 5 minutes can meet your needs, we recommend choosing the cheaper V3.

API Method

shell

POST /v2/order/submit

Request params

Field	Position	Type	Required	Description
resource_type	body	integer	false	Pass 0 for bandwidth, 1 for energy，only 1 is allowed
receive_address	body	string	true	Resource receiving address
resource_value	body	integer	true	The number of resources to rent
rent_duration	body	integer	true	When the time unit is equal to 'd', 1-30, when the time unit is equal to 'h', only 1 and 3, when the time unit is equal to 'm', only 10 are supported temporarily
rent_time_unit	body	string	true	Only allowed 'd', 'h' and 'm'
rent_time_second	body	integer	true	The rental duration (seconds) must be greater than 600 and a multiple of 3. You can also request the Query APIKEY Details to obtain the allowed duration. If this parameter is not empty and valid, the `rent_duration` and `rent_time_unit` parameters will be ignored. If it is 0, `rent_duration` and `rent_time_unit` will be used to set the order duration.

Request params example

json

{
    "resource_type": 1,
    "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "resource_value": 100000,
    "rent_duration": 1,
    "rent_time_unit": "h",
    "rent_time_second": 600
}

Responses

Field	Type	Required
code	integer	true
msg	string	true
request_id	string	true
data	BuyOrderDetail	false

Response example

json

{
    "code": 0,
    "msg": "success",
    "request_id": "4fb9aac4-573f-4c3a-afc6-94d68270b12c",
    "data": {
        "order_no": "2409254945397237760100",
        "order_type": 0,
        "resource_type": 1,
        "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "price_in_sun": 120,
        "freeze_time": 0,
        "create_time": 1727254190,
        "resource_value": 32000,
        "frozen_resource_value": 0,
        "rent_duration": 1,
        "rent_time_unit": "d",
        "rent_time_second": 86400,
        "rent_expire_time": 0,
        "frozen_tx_id": "",
        "pay_time": 1727254190,
        "pay_amount": 4.4,
        "refund_amount": 0,
        "refund_time": 0,
        "is_split": 0,
        "is_lock": 1,
        "lock_period": 28800,
        "status": 4,
        "business_status": 1
    }
}

Code demo

Shell

shell

curl --location --request POST 'https://feee.io/open/v2/order/submit' \
--header 'key: <key>' \
--header 'User-Agent: Feee.io Shell Client/1.0.0 (https://feee.io)' \
--header 'Content-Type: application/json' \
--data-raw '<body data here>'

Golang

package main

import (
   "fmt"
   "strings"
   "net/http"
   "io/ioutil"
)

func main() {

   url := "https://feee.io/open/v2/order/submit"
   method := "POST"

   payload := strings.NewReader(`<body data here>`)

   client := &http.Client {
   }
   req, err := http.NewRequest(method, url, payload)

   if err != nil {
      fmt.Println(err)
      return
   }
   req.Header.Add("key", "<key>")
   req.Header.Add("User-Agent", "Feee.io Golang Client/1.0.0 (https://feee.io)")
   req.Header.Add("Content-Type", "application/json")

   res, err := client.Do(req)
   if err != nil {
      fmt.Println(err)
      return
   }
   defer res.Body.Close()

   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
      fmt.Println(err)
      return
   }
   fmt.Println(string(body))
}

PHP

php

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
   CURLOPT_URL => 'https://feee.io/open/v2/order/submit',
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_ENCODING => '',
   CURLOPT_MAXREDIRS => 10,
   CURLOPT_TIMEOUT => 0,
   CURLOPT_FOLLOWLOCATION => true,
   CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
   CURLOPT_CUSTOMREQUEST => 'POST',
   CURLOPT_POSTFIELDS =>'<body data here>',
   CURLOPT_HTTPHEADER => array(
      'key: <key>',
      'User-Agent: Feee.io PHP Client/1.0.0 (https://feee.io)',
      'Content-Type: application/json'
   ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python

python

import http.client
import json

conn = http.client.HTTPSConnection("feee.io")
payload = "<body data here>"
headers = {
   'key': '<key>',
   'User-Agent': 'Feee.io Python Client/1.0.0 (https://feee.io)',
   'Content-Type': 'application/json'
}
conn.request("POST", "/open/v2/order/submit", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Java

java

OkHttpClient client = new OkHttpClient().newBuilder()
   .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "<body data here>");
Request request = new Request.Builder()
   .url("https://feee.io/open/v2/order/submit")
   .method("POST", body)
   .addHeader("key", "<key>")
   .addHeader("User-Agent", "Feee.io Java Client/1.0.0 (https://feee.io)")
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();

Create Order V2 ​

API Method ​

Request params ​

Request params example ​

Responses ​

Response example ​

Code demo ​

Shell ​

Golang ​

PHP ​

Python ​

Java ​

Create Order V2

API Method

Request params

Request params example

Responses

Response example

Code demo

Shell

Golang

PHP

Python

Java