Skip to content

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 at 5 minutes. If 5 minutes can meet your needs, we recommend choosing the cheaper V3.

API Method

shell
POST /v3/order/create

Request params

FieldPositionTypeRequiredDescription
resource_typebodyintegerfalsePass 0 for bandwidth, 1 for energy,only 1 is allowed
receive_addressbodystringtrueResource receiving address
resource_valuebodyintegertrueThe number of resources to rent

Request params example

json
{
    "resource_type": 1,
    "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "resource_value": 100000
}

Responses

FieldTypeRequiredDescription
codeintegertrue
msgstringtrue
request_idstringtrue
dataBuyOrderDetailfalse

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();