Update Maker Order
API-v1update_maker_order
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, there is a lower limit to the value of a trade. See the description of the volume_delta and min_volume arguments for more information.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| base_confs | number (optional) | ✗ | - | Number of required blockchain confirmations for base coin atomic swap transaction; defaults to base coin configuration if not set |
| base_nota | bool (optional) | ✗ | - | Whether dPoW notarization is required for base coin atomic swap transaction; defaults to base coin configuration if not set |
| max | bool (optional) | ✗ | false | Komodo DeFi Framework API will use the entire coin balance for the order, taking 0.001 coins into reserve to account for fees |
| 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:
|
| new_price | numeric string or rational (optional) | ✗ | - | The price in rel the user is willing to receive per one unit of the base coin |
| rel_confs | number (optional) | ✗ | - | Number of required blockchain confirmations for rel coin atomic swap transaction; defaults to rel coin configuration if not set |
| rel_nota | bool (optional) | ✗ | - | Whether dPoW notarization is required for rel coin atomic swap transaction; defaults to rel coin configuration if not set |
| uuid | string | ✓ | - | The uuid of the order the user desires to update |
| 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:
|
| Parameter | Type | Description |
|---|---|---|
| base | string | The base coin of the order |
| conf_settings | object | A standard ConfSettings object. |
| created_at | number | Unix timestamp in milliseconds, indicating the order creation time |
| matches | object | Contains the map of ongoing matches with other orders, empty as the order was recently created |
| 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 will not match with other orders that attempt to trade less than min_base_vol; decimal representation |
| min_base_vol_rat | rational | Komodo DeFi Framework API will not match with other orders that attempt to trade less than min_base_vol; rational representation |
| 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 |
| rel | string | The rel coin of the order |
| started_swaps | array of strings | UUIDs of swaps that were initiated by the order |
| updated_at | number | Unix timestamp in milliseconds, indicating the order update time |
| uuid | string | UUID of the updated order |
update_maker_order
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"
}
update_maker_order
POST
update_maker_order{
"userpass": "RPC_UserP@SSW0RD",
"method": "update_maker_order",
"uuid": "6a242691-6c05-474a-85c1-5b3f42278f41",
"new_price": "0.9",
"max": true
}
update_maker_order
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
]
]
]
}
update_maker_order
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"
}
}
update_maker_order
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"
}
update_maker_order
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
}