update_maker_order
update_maker_order uuid (new_price volume_delta max base_confs base_nota rel_confs rel_nota min_volume)
The update_maker_order method updates an active order on the orderbook created before by setprice, and it relies on this node acting as a maker, also called a Bob node.
Arguments
| Structure | Type | Description |
|---|---|---|
| uuid | string | the uuid of the order the user desires to update |
| new_price | numeric string or rational (optional) | the price in rel the user is willing to receive per one unit of the base coin |
| volume_delta | numeric string or rational (optional) | volume added to or subtracted from the max_base_vol of the order to be updated, resulting in the new volume which is the maximum amount of base coin available for the order, ignored if max is true; the following values must be greater than or equal to the min_trading_vol of the corresponding coin:
|
| min_volume | numeric string or rational (optional) | the minimum amount of base coin available for the order; it must be less or equal than the new volume; the following values must be greater than or equal to the min_trading_vol of the corresponding coin:
|
| max | bool (optional) | Komodo DeFi Framework API will use the entire coin balance for the order, taking 0.001 coins into reserve to account for fees |
| base_confs | number (optional) | number of required blockchain confirmations for base coin atomic swap transaction; default to base coin configuration if not set |
| base_nota | bool (optional) | whether dPoW notarization is required for base coin atomic swap transaction; default to base coin configuration if not set |
| rel_confs | number (optional) | number of required blockchain confirmations for rel coin atomic swap transaction; default to rel coin configuration if not set |
| rel_nota | bool (optional) | whether dPoW notarization is required for rel coin atomic swap transaction; default to rel coin configuration if not set |
Response
| Structure | Type | Description |
|---|---|---|
| base | string | the base coin of the order |
| rel | string | the rel coin of the order |
| price | string (numeric) | the expected amount of rel coin to be received per 1 unit of base coin; decimal representation |
| price_rat | rational | the expected amount of rel coin to be received per 1 unit of base coin; rational representation |
| max_base_vol | string (numeric) | the maximum volume of base coin available to trade; decimal representation |
| max_base_vol_rat | rational | the maximum volume of base coin available to trade; rational representation |
| min_base_vol | string (numeric) | Komodo DeFi Framework API won’t match with other orders that attempt to trade less than min_base_vol; decimal representation |
| min_base_vol_rat | rational | Komodo DeFi Framework API won’t match with other orders that attempt to trade less than min_base_vol; rational representation |
| created_at | number | unix timestamp in milliseconds, indicating the order creation time |
| updated_at | number | unix timestamp in milliseconds, indicating the order update time |
| matches | object | contains the map of ongoing matches with other orders, empty as the order was recently created |
| started_swaps | array of strings | uuids of swaps that were initiated by the order |
| uuid | string | uuid of the updated order |
| conf_settings | object | A standard ConfSettings object. |
📌 Examples
Command (with volume)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","new_price":"0.9","volume_delta":"1"}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"volume_delta": "1"
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Command (max = true)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","new_price":"0.9","max":true}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Command (rational representation in num-rational crate format)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","volume_delta":[[1,[1]],[1,[1]]],"new_price":[[1,[1]],[1,[1]]]}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": [
[
1,
[
1
]
],
[
1,
[
1
]
]
],
"new_price": [
[
1,
[
1
]
],
[
1,
[
1
]
]
]
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Command (rational representation as fraction object)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","volume_delta":{"numer":"3","denom":"2"},"new_price":{"numer":"2","denom":"1"}}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
}
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Command (with min_volume)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","volume_delta":{"numer":"3","denom":"2"},"new_price":{"numer":"2","denom":"1"},"min_volume":"1"}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"min_volume": "1"
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Command (with confirmations and notarization settings)
POST update_maker_order
{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
};
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
}
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":"update_maker_order","uuid":"6a242691-6c05-474a-85c1-5b3f42278f41","volume_delta":{"numer":"3","denom":"2"},"new_price":{"numer":"2","denom":"1"},"base_confs":2,"base_nota":true,"rel_confs":5,"rel_nota":false}`)
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": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"volume_delta": {
"numer": "3",
"denom": "2"
},
"new_price": {
"numer": "2",
"denom": "1"
},
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Show Response
Response (success)
{
"result": {
"base": "BASE",
"rel": "REL",
"max_base_vol": "1",
"max_base_vol_rat": [
[1, [1]],
[1, [1]]
],
"min_base_vol": "0",
"min_base_vol": [
[0, []],
[1, [1]]
],
"created_at": 1559052299258,
"updated_at": 1619736650000,
"matches": {},
"price": "1",
"price_rat": [
[1, [1]],
[1, [1]]
],
"started_swaps": [],
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"conf_settings": {
"base_confs": 2,
"base_nota": true,
"rel_confs": 5,
"rel_nota": false
}
}
}Response (error)
{ "error": "There is no order with UUID 6a242691-6c05-474a-85c1-5b3f42278f41" }