order_status

order_status uuid

The order_status method returns the data of the order with the selected uuid created by the Komodo DeFi Framework API node. The response is different for maker and taker orders.

Argument

Structure	Type	Description
uuid	string	uuid of order to display

Command

POST order_status

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
};

const response = await fetch("http://127.0.0.1:7783", {
  method: "POST",
  body: JSON.stringify(payload),
});

console.log(await response.json());

<?php

$payload = <<<'JSON'
{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
}
JSON;

$ch = curl_init("http://127.0.0.1:7783");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

package main

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

func main() {
	payload := []byte(`{"userpass":"RPC_UserP@SSW0RD","method":"order_status","uuid":"c3b3105c-e914-4ed7-9f1c-604783b054a1"}`)

	resp, err := http.Post("http://127.0.0.1:7783", "application/json", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI("http://127.0.0.1:7783")
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "order_status",
  "uuid": "c3b3105c-e914-4ed7-9f1c-604783b054a1"
}

response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body))

Response (No order found)

{ "error": "Order with uuid c3b3105c-e914-4ed7-9f1c-604783b054a1 is not found" }

Maker Order Response

Structure	Type	Description
type	string	type of the order (“Maker” or “Taker”)
order	object	A standard OrderStatusData object.
base_orderbook_ticker	string	The orderbook ticker for base coin. This field is used to group segwit and non-segwit versions of UTXO coins.
rel_orderbook_ticker	string	The orderbook ticker for rel coin. This field is used to group segwit and non-segwit versions of UTXO coins.

📌 Maker Order Examples

Show Response

{
  "order": {
    "available_amount": "1",
    "base": "BEER",
    "cancellable": true,
    "created_at": 1568808684710,
    "matches": {
      "60aaacca-ed31-4633-9326-c9757ea4cf78": {
        "connect": {
          "dest_pub_key": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920",
          "maker_order_uuid": "fedd5261-a57e-4cbf-80ac-b3507045e140",
          "method": "connect",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "taker_order_uuid": "60aaacca-ed31-4633-9326-c9757ea4cf78"
        },
        "connected": {
          "dest_pub_key": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "maker_order_uuid": "fedd5261-a57e-4cbf-80ac-b3507045e140",
          "method": "connected",
          "sender_pubkey": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920",
          "taker_order_uuid": "60aaacca-ed31-4633-9326-c9757ea4cf78"
        },
        "last_updated": 1560529572571,
        "request": {
          "action": "Buy",
          "base": "BEER",
          "base_amount": "1",
          "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
          "method": "request",
          "rel": "PIZZA",
          "rel_amount": "1",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "uuid": "60aaacca-ed31-4633-9326-c9757ea4cf78"
        },
        "reserved": {
          "base": "BEER",
          "base_amount": "1",
          "dest_pub_key": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "maker_order_uuid": "fedd5261-a57e-4cbf-80ac-b3507045e140",
          "method": "reserved",
          "rel": "PIZZA",
          "rel_amount": "1",
          "sender_pubkey": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920",
          "taker_order_uuid": "60aaacca-ed31-4633-9326-c9757ea4cf78"
        }
      }
    },
    "max_base_vol": "1",
    "max_base_vol_rat": [
      [1, [1]],
      [1, [1]]
    ],
    "min_base_vol": "0",
    "min_base_vol_rat": [
      [0, []],
      [1, [1]]
    ],
    "price": "1",
    "price_rat": [
      [1, [1]],
      [1, [1]]
    ],
    "rel": "ETOMIC",
    "started_swaps": ["60aaacca-ed31-4633-9326-c9757ea4cf78"],
    "uuid": "ea77dcc3-a711-4c3d-ac36-d45fc5e1ee0c"
  },
  "type": "Maker",
  "base_orderbook_ticker": null,
  "rel_orderbook_ticker": null
}

Maker Order Response (Cancelled order from history)

{
  "type": "Maker",
  "order": {
    "base": "DGB",
    "rel": "KMD",
    "price": "0.05009337477044780336205678768187597118237039129820596129396807458680604605170221782737674812826670434",
    "price_rat": [
      [1, [354611]],
      [1, [7079000]]
    ],
    "max_base_vol": "2509.982886480319452367370222475755847119224187107815173987450085567598402738163148887621220764403879",
    "max_base_vol_rat": [
      [1, [4400000]],
      [1, [1753]]
    ],
    "min_base_vol": "227.8553118769581315864426089433209911706066647678724010253489034463115921389917402449444602677299915",
    "min_base_vol_rat": [
      [1, [800000]],
      [1, [3511]]
    ],
    "created_at": 1640147130806,
    "updated_at": 1640148500481,
    "matches": {
      "ca791f47-3a84-414b-b7c1-942a0f2fb4ca": {
        "request": {
          "base": "KMD",
          "rel": "DGB",
          "base_amount": "12",
          "base_amount_rat": [
            [1, [12]],
            [1, [1]]
          ],
          "rel_amount": "241.1820189434802008438151288032397078840799082760529333024574562419162623621175580193501380942429668",
          "rel_amount_rat": [
            [1, [42702000]],
            [1, [177053]]
          ],
          "action": "Sell",
          "uuid": "ca791f47-3a84-414b-b7c1-942a0f2fb4ca",
          "method": "request",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
          "match_by": {
            "type": "Any"
          },
          "conf_settings": {
            "base_confs": 2,
            "base_nota": true,
            "rel_confs": 7,
            "rel_nota": false
          }
        },
        "reserved": {
          "base": "DGB",
          "rel": "KMD",
          "base_amount": "241.1820189434802008438151288032397078840799082760529333024574562419162623621175580193501380942429668",
          "base_amount_rat": [
            [1, [42702000]],
            [1, [177053]]
          ],
          "rel_amount": "12",
          "rel_amount_rat": [
            [1, [12]],
            [1, [1]]
          ],
          "taker_order_uuid": "ca791f47-3a84-414b-b7c1-942a0f2fb4ca",
          "maker_order_uuid": "9c034d5f-18d6-494d-8460-7974be2d5beb",
          "sender_pubkey": "caecf84197b88739079e55c92f26fe4bc329220a74d7f9d2094dc16e5a0d765e",
          "dest_pub_key": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920",
          "conf_settings": {
            "base_confs": 3,
            "base_nota": true,
            "rel_confs": 3,
            "rel_nota": true
          },
          "method": "reserved"
        },
        "connect": {
          "taker_order_uuid": "ca791f47-3a84-414b-b7c1-942a0f2fb4ca",
          "maker_order_uuid": "9c034d5f-18d6-494d-8460-7974be2d5beb",
          "method": "connect",
          "sender_pubkey": "0000000000000000000000000000000000000000000000000000000000000000",
          "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000"
        },
        "connected": {
          "taker_order_uuid": "ca791f47-3a84-414b-b7c1-942a0f2fb4ca",
          "maker_order_uuid": "9c034d5f-18d6-494d-8460-7974be2d5beb",
          "method": "connected",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000"
        },
        "last_updated": 1640147223000
      }
    },
    "started_swaps": ["ca791f47-3a84-414b-b7c1-942a0f2fb4ca"],
    "uuid": "9c034d5f-18d6-494d-8460-7974be2d5beb",
    "conf_settings": {
      "base_confs": 3,
      "base_nota": true,
      "rel_confs": 3,
      "rel_nota": true
    },
    "base_orderbook_ticker": null,
    "rel_orderbook_ticker": null
  },
  "cancellation_reason": "Cancelled"
}

Response: Taker Orders

Structure	Type	Description
type	string	type of the order (“Maker” or “Taker”)
order	object	A standard OrderStatusData object.
base_orderbook_ticker	string	The orderbook ticker for base coin. This field is used to group segwit and non-segwit versions of UTXO coins.
rel_orderbook_ticker	string	The orderbook ticker for rel coin. This field is used to group segwit and non-segwit versions of UTXO coins.

📌 Taker Order Examples

Show Response

Response: Taker Order Fullfilled

{
  "type": "Taker",
  "order": {
    "created_at": 1640159838631,
    "request": {
      "base": "DOC",
      "rel": "MARTY",
      "base_amount": "1",
      "base_amount_rat": [
        [1, [1]],
        [1, [1]]
      ],
      "rel_amount": "33",
      "rel_amount_rat": [
        [1, [33]],
        [1, [1]]
      ],
      "action": "Buy",
      "uuid": "d1a43d2a-f7c1-4a83-ba32-1ae640cc3b32",
      "method": "request",
      "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
      "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
      "match_by": {
        "type": "Any"
      },
      "conf_settings": {
        "base_confs": 1,
        "base_nota": false,
        "rel_confs": 1,
        "rel_nota": false
      }
    },
    "matches": {
      "cc9efdb5-e0f1-4196-b3b2-e4930623c976": {
        "reserved": {
          "base": "DOC",
          "rel": "MARTY",
          "base_amount": "1",
          "base_amount_rat": [
            [1, [1]],
            [1, [1]]
          ],
          "rel_amount": "1",
          "rel_amount_rat": [
            [1, [1]],
            [1, [1]]
          ],
          "taker_order_uuid": "d1a43d2a-f7c1-4a83-ba32-1ae640cc3b32",
          "maker_order_uuid": "cc9efdb5-e0f1-4196-b3b2-e4930623c976",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
          "conf_settings": {
            "base_confs": 1,
            "base_nota": false,
            "rel_confs": 1,
            "rel_nota": false
          },
          "method": "reserved"
        },
        "connect": {
          "taker_order_uuid": "d1a43d2a-f7c1-4a83-ba32-1ae640cc3b32",
          "maker_order_uuid": "cc9efdb5-e0f1-4196-b3b2-e4930623c976",
          "method": "connect",
          "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
          "dest_pub_key": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920"
        },
        "connected": null,
        "last_updated": 0
      }
    },
    "order_type": {
      "type": "FillOrKill"
    },
    "cancellable": false,
    "base_orderbook_ticker": null,
    "rel_orderbook_ticker": null
  },
  "cancellation_reason": "Fulfilled"
}

Response: ‘FillOrKill’ Taker order after timeout with no match

{
  "type": "Taker",
  "order": {
    "created_at": 1640159991278,
    "request": {
      "base": "DOC",
      "rel": "MARTY",
      "base_amount": "1",
      "base_amount_rat": [
        [1, [1]],
        [1, [1]]
      ],
      "rel_amount": "0.03",
      "rel_amount_rat": [
        [1, [3]],
        [1, [100]]
      ],
      "action": "Buy",
      "uuid": "6053016b-e1ba-490f-9501-eafb69b4d3a7",
      "method": "request",
      "sender_pubkey": "5a2f1c468b7083c4f7649bf68a50612ffe7c38b1d62e1ece3829ca88e7e7fd12",
      "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
      "match_by": {
        "type": "Any"
      },
      "conf_settings": {
        "base_confs": 1,
        "base_nota": false,
        "rel_confs": 1,
        "rel_nota": false
      }
    },
    "matches": {},
    "order_type": {
      "type": "FillOrKill"
    },
    "cancellable": true,
    "base_orderbook_ticker": null,
    "rel_orderbook_ticker": null
  },
  "cancellation_reason": "TimedOut"
}

order_status#

Argument#

Command#

Response (No order found)#

Maker Order Response#

📌 Maker Order Examples#

Maker Order Response (Cancelled order from history)#

Response: Taker Orders#

📌 Taker Order Examples#

Response: Taker Order Fullfilled#

Response: ‘FillOrKill’ Taker order after timeout with no match#