Create Order V3
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 at5 minutes
. If 5 minutes can meet your needs, we recommend choosing the cheaper V3.
API Method
shell
POST /v3/order/create
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 |
Request params example
json
{
"resource_type": 1,
"receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"resource_value": 100000
}
Responses
Field | Type | Required | Description |
---|---|---|---|
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/v3/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
go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://feee.io/open/v3/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/v3/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/v3/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/v3/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();