Create Order

curl --request POST \
  --url https://api.centosfi.com/v1/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "qty": 123,
  "buy_flag": true,
  "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "price": 0.5,
  "centos_id": 123,
  "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "expiry_ts_utc": "2023-11-07T05:31:56Z",
  "conditional_orders_params": [
    {
      "trigger_order": {
        "qty": 123,
        "buy_flag": true,
        "price": 0.5,
        "stop_order_price": 0.5
      },
      "stop_order_price": 0.5,
      "parent_centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_complex_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}
'

import requests

url = "https://api.centosfi.com/v1/orders"

payload = {
    "qty": 123,
    "buy_flag": True,
    "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "price": 0.5,
    "centos_id": 123,
    "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "expiry_ts_utc": "2023-11-07T05:31:56Z",
    "conditional_orders_params": [
        {
            "trigger_order": {
                "qty": 123,
                "buy_flag": True,
                "price": 0.5,
                "stop_order_price": 0.5
            },
            "stop_order_price": 0.5,
            "parent_centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "parent_complex_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    qty: 123,
    buy_flag: true,
    subaccount_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    price: 0.5,
    centos_id: 123,
    custom_asset_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    expiry_ts_utc: '2023-11-07T05:31:56Z',
    conditional_orders_params: [
      {
        trigger_order: {qty: 123, buy_flag: true, price: 0.5, stop_order_price: 0.5},
        stop_order_price: 0.5,
        parent_centos_order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        parent_complex_order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
      }
    ]
  })
};

fetch('https://api.centosfi.com/v1/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.centosfi.com/v1/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'qty' => 123,
    'buy_flag' => true,
    'subaccount_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'price' => 0.5,
    'centos_id' => 123,
    'custom_asset_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'expiry_ts_utc' => '2023-11-07T05:31:56Z',
    'conditional_orders_params' => [
        [
                'trigger_order' => [
                                'qty' => 123,
                                'buy_flag' => true,
                                'price' => 0.5,
                                'stop_order_price' => 0.5
                ],
                'stop_order_price' => 0.5,
                'parent_centos_order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'parent_complex_order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.centosfi.com/v1/orders"

	payload := strings.NewReader("{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.centosfi.com/v1/orders")
  .header("Content-Type", "application/json")
  .body("{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.centosfi.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "complex_orders": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Orders

Create Order

Place a new order.

Submits an order for asynchronous processing. The order is persisted immediately and queued for execution on the target exchange.

See Orders and Order Types for more information.

Asset Selection: Provide exactly one of centos_id (standard instrument) or custom_asset_id (user-defined basket). Custom asset orders only support MARKET order type — the system automatically routes IOC limit orders to each underlying instrument at optimal prices.

Response: Returns 202 Accepted with the order_id and associated complex_orders ids (TP/SL). Poll GET /v1/orders/{order_id} or use webhooks to track execution.

POST

orders

Create Order

curl --request POST \
  --url https://api.centosfi.com/v1/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "qty": 123,
  "buy_flag": true,
  "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "price": 0.5,
  "centos_id": 123,
  "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "expiry_ts_utc": "2023-11-07T05:31:56Z",
  "conditional_orders_params": [
    {
      "trigger_order": {
        "qty": 123,
        "buy_flag": true,
        "price": 0.5,
        "stop_order_price": 0.5
      },
      "stop_order_price": 0.5,
      "parent_centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_complex_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}
'

import requests

url = "https://api.centosfi.com/v1/orders"

payload = {
    "qty": 123,
    "buy_flag": True,
    "subaccount_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "price": 0.5,
    "centos_id": 123,
    "custom_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "expiry_ts_utc": "2023-11-07T05:31:56Z",
    "conditional_orders_params": [
        {
            "trigger_order": {
                "qty": 123,
                "buy_flag": True,
                "price": 0.5,
                "stop_order_price": 0.5
            },
            "stop_order_price": 0.5,
            "parent_centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "parent_complex_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    qty: 123,
    buy_flag: true,
    subaccount_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    price: 0.5,
    centos_id: 123,
    custom_asset_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    expiry_ts_utc: '2023-11-07T05:31:56Z',
    conditional_orders_params: [
      {
        trigger_order: {qty: 123, buy_flag: true, price: 0.5, stop_order_price: 0.5},
        stop_order_price: 0.5,
        parent_centos_order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        parent_complex_order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
      }
    ]
  })
};

fetch('https://api.centosfi.com/v1/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.centosfi.com/v1/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'qty' => 123,
    'buy_flag' => true,
    'subaccount_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'price' => 0.5,
    'centos_id' => 123,
    'custom_asset_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'expiry_ts_utc' => '2023-11-07T05:31:56Z',
    'conditional_orders_params' => [
        [
                'trigger_order' => [
                                'qty' => 123,
                                'buy_flag' => true,
                                'price' => 0.5,
                                'stop_order_price' => 0.5
                ],
                'stop_order_price' => 0.5,
                'parent_centos_order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'parent_complex_order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.centosfi.com/v1/orders"

	payload := strings.NewReader("{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.centosfi.com/v1/orders")
  .header("Content-Type", "application/json")
  .body("{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.centosfi.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"qty\": 123,\n  \"buy_flag\": true,\n  \"subaccount_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"price\": 0.5,\n  \"centos_id\": 123,\n  \"custom_asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"expiry_ts_utc\": \"2023-11-07T05:31:56Z\",\n  \"conditional_orders_params\": [\n    {\n      \"trigger_order\": {\n        \"qty\": 123,\n        \"buy_flag\": true,\n        \"price\": 0.5,\n        \"stop_order_price\": 0.5\n      },\n      \"stop_order_price\": 0.5,\n      \"parent_centos_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"parent_complex_order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "centos_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "complex_orders": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Body

application/json

Schema for creating a new order.

order_type

enum<string>

required

Order type: 'LIMIT' or 'MARKET'

Available options:

LIMIT,

MARKET

time_in_force

enum<string>

required

Time in force: 'FOK', 'GTC', 'GTD', or 'IOC'

Available options:

FOK,

GTC,

GTD,

IOC

qty

number

required

Order quantity (number of contracts)

buy_flag

boolean

required

Order direction: true=buy, false=sell

subaccount_id

string<uuid>

required

Subaccount to place the order under

price

number | null

Limit price between 0 and 1. Required for LIMIT orders.

Required range: 0 < x < 1

centos_id

integer | null

Instrument ID. Mutually exclusive with custom_asset_id.

custom_asset_id

string<uuid> | null

Custom asset basket UUID. Mutually exclusive with centos_id.

expiry_ts_utc

string<date-time> | null

Expiry timestamp in UTC(ISO 8601). Required for GTD orders. i.e '2023-11-07T05:31:56Z'

conditional_orders_params

ConditionalOrderCreate · object[] | null

Optional list of conditional orders (TP/SL) to attach to this order.

Show child attributes

Response

Successful Response

Schema for order create response.

centos_order_id

string<uuid>

required

Unique order identifier

complex_orders

Complex Orders · object

required

List of complex centos orders id

Show child attributes

Overview

Markets

Orders

Complex Orders

Subaccounts

Portfolio

Market Data

Custom Assets

Create Order

Body

Response