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.
To prevent a user from making trades in which the transaction fees may end up costing a significant portion of the value of the trade, we have set a lower limit to the value of a trade. See the description of the volume_delta and min_volume arguments for more info.
| 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 |
| 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. |
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"
}
POST
update_maker_order{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}
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
]
]
]
}
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"
}
}
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"
}
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
}