注文の作成 V2

TIP

• この API はクイック取引の注文のみを作成します。エネルギーが十分にあれば注文は成功します。ほかの条件で注文する場合はプラットフォームの自由取引市場をご利用ください。自由取引市場での API 注文が必要な場合は、お問い合わせください。
• エネルギーが十分にある場合、通常 3～6 秒以内に受取アドレスへ委任されます。
• V2 API では、より多くのレンタル期間を選択できます。
• V3 API は 2024 年 12 月に提供を開始しました。V2 より安価ですが、レンタル期間は 5 分間 固定です。5 分間で足りる場合は V3 API をお勧めします。

API エンドポイント

POST /v2/order/submit

リクエストパラメータ

項目	指定箇所	型	必須	説明
resource_type	body	integer	false	0 は帯域幅、1 はエネルギー。現在はエネルギーのみ対応
receive_address	body	string	true	リソース受取アドレス
resource_value	body	integer	true	レンタルするリソース量
rent_duration	body	integer	true	レンタル期間。単位が h の場合は現在 1 または 3 時間、m の場合は 10 分のみ対応
rent_time_unit	body	string	true	レンタル期間の単位。d（日）、h（時間）、m（分）のみ対応
rent_time_second	body	integer	true	レンタル期間（秒）。600 以上かつ 3 の倍数で指定します。使用可能な期間は API キーの詳細取得 API で確認できます。有効な 0 以外の値を指定すると rent_duration と rent_time_unit は無視されます。0 の場合は、この 2 つのパラメータで期間を指定します

パラメータ例

{
    "resource_type": 1,
    "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "resource_value": 32000,
    "rent_duration": 10,
    "rent_time_unit": "m",
    "rent_time_second": 600
}

API レスポンス

項目	型	必須	説明
code	integer	true
msg	string	true
request_id	string	true
data	BuyOrderDetail	false

レスポンス例

{
    "code": 0,
    "msg": "成功",
    "request_id": "4fb9aac4-573f-4c3a-afc6-94d68270b12c",
    "data": {
        "order_no": "2409254945397237760100",
        "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": 10,
        "rent_time_unit": "m",
        "rent_time_second": 600,
        "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
    }
}

コード例

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

$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

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

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