sell

sell base rel price volume (match_by order_type base_confs base_nota rel_confs rel_nota)

The sell method issues a sell request and attempts to match an order from the orderbook based on the provided arguments.

Buy and sell methods always create the taker order first. A taker order must pay a dexfee during the swap as it is taking liquidity from the market. The dexfee is calculated as "the greater of either Minimum transaction amount (dust) TAKER COIN or 0.0001 TAKER COIN or 1/777th the size of the desired order". If your GoodTillCancelled order is not matched in 30 seconds, the order is automatically converted to a maker request and stays on the orderbook until the request is matched or cancelled. To always act as a maker, please use the setprice method.
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 argument for more info.

Arguments

Structure	Type	Description
base	string	the name of the coin the user desires to sell
rel	string	the name of the coin the user desires to receive
price	varies	The price in `rel` the user is willing to pay per one unit of the `base` coin. Can be a numeric string, expressed using standard RationalValue or FractionalValue objects.
volume	varies	The amount of coins the user is willing to receive of the `base` coin; the following values must be greater than or equal to the `min_trading_vol` of the corresponding coin: the argument `volume` the product of the arguments `volume` and `price` . . Can be a numeric string, expressed using standard RationalValue or FractionalValue objects.
min_volume	varies (optional)	The amount of `base` coin that will be used as `min_volume` of `GoodTillCancelled` order after conversion to maker; the following values must be greater than or equal to the `min_trading_vol` of the corresponding coin: the argument `min_volume` the product of the arguments `min_volume` and `price` . . Can be a numeric string, expressed using standard RationalValue or FractionalValue objects.
match_by	object	Optional. A standard MatchBy object, to filter to include only matches by pubkey or uuid. Important: This condition is not applied after a `GoodTillCancelled` order is converted to a `maker` request.
order_type	object	Optional. A standard OrderType object.
base_confs	number	number of required blockchain confirmations for base coin atomic swap transaction; default to base coin configuration if not set
base_nota	bool	whether dPoW notarization is required for base coin atomic swap transaction; default to base coin configuration if not set
rel_confs	number	number of required blockchain confirmations for rel coin atomic swap transaction; default to rel coin configuration if not set
rel_nota	bool	whether dPoW notarization is required for rel coin atomic swap transaction; default to rel coin configuration if not set
save_in_history	boolean	Defaults to `true`. If set to `false` no order history will be saved (though order status will be temporarily stored while in progress). If `true`, each order's short record history is stored in a local SQLite database table, and when the order is cancelled or fully matched, it's history will be saved as a json file

Response

Structure	Type	Description
action	string	the action of the request (`Sell`)
base	string	the base currency of the request
base_amount	numeric string	the resulting amount of base currency that is sold if the order matches, represented as a decimal value.
base_amount_rat	rational	the resulting amount of base currency that is sold if the order matches, represented as a standard RationalValue object.
rel	string	the rel currency of the request
rel_amount	string	the minimum amount of `rel` coin that must be received in order to sell the `base_amount` of `base` (according to `price`, in decimal representation)
rel_amount_rat	rational	the minimum amount of `rel` coin that must be received in order to sell the `base_amount` of `base` (according to `price`, represented as a standard RationalValue object).
method	string	this field is used for internal P2P interactions; the value is always equal to "request
dest_pub_key	string	reserved for future use. The `dest_pub_key` allows the user to choose the P2P node that is eligible to match with the request. This value defaults to "zero pubkey", meaning that `anyone` can match
sender_pubkey	string	the public key of our node
uuid	string	the request uuid
match_by	object	A standard MatchBy object, to filter to include only matches by pubkey or uuid. Important: This condition is not applied after a `GoodTillCancelled` order is converted to a `maker` request.
conf_settings	object	A standard ConfSettings object.
base_orderbook_ticker	string	the ticker of the base currency if `orderbook_ticker` is configured for the base currency in `coins` file. If not defined, will return a null value.
rel_orderbook_ticker	string	the ticker of the rel currency if `orderbook_ticker` is configured for the rel currency in `coins` file. If not defined, will return a null value.

📌 Examples

Command (decimal representation)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": "1",
  "price": "1"
}

Command (rational representation in num-rational crate format)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ]
}

Command (rational representation as a fraction object)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "HELLO",
  "rel": "WORLD",
  "volume": {
    "numer": "3",
    "denom": "2"
  },
  "price": {
    "numer": "2",
    "denom": "1"
  }
}

Command (with confirmations and notarization settings)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "HELLO",
  "rel": "WORLD",
  "volume": {
    "numer": "3",
    "denom": "2"
  },
  "price": {
    "numer": "2",
    "denom": "1"
  },
  "base_confs": 2,
  "base_nota": true,
  "rel_confs": 5,
  "rel_nota": false
}

Command (set to not save order history)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "TKL",
  "rel": "DUST",
  "volume": {
    "numer": "5",
    "denom": "2"
  },
  "price": {
    "numer": "9",
    "denom": "4"
  },
  "save_in_history": false
}

Command (GoodTillCancelled type)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "order_type": {
    "type": "GoodTillCancelled"
  }
}

Command (FillOrKill type)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "order_type": {
    "type": "FillOrKill"
  }
}

Command (match by Any)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "match_by": {
    "type": "Any"
  }
}

Command (match by Pubkeys)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "match_by": {
    "type": "Pubkeys",
    "data": [
      "1ab7edc96abaefb358b52c583048eaaeb8ea42609d096d6cddfafa02fa510c6a"
    ]
  }
}

Command (match by Orders)

POST

sell

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sell",
  "base": "BASE",
  "rel": "REL",
  "volume": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "price": [
    [
      1,
      [
        1
      ]
    ],
    [
      1,
      [
        1
      ]
    ]
  ],
  "match_by": {
    "type": "Orders",
    "data": [
      "d14452bb-e82d-44a0-86b0-10d4cdcb8b24"
    ]
  }
}

Response (success)

{
  "result": {
    "action": "Sell",
    "base": "BASE",
    "base_amount": "1",
    "base_amount_rat": [
      [1, [1]],
      [1, [1]]
    ],
    "dest_pub_key": "0000000000000000000000000000000000000000000000000000000000000000",
    "method": "request",
    "rel": "REL",
    "rel_amount": "1",
    "rel_amount_rat": [
      [1, [1]],
      [1, [1]]
    ],
    "sender_pubkey": "c213230771ebff769c58ade63e8debac1b75062ead66796c8d793594005f3920",
    "uuid": "d14452bb-e82d-44a0-86b0-10d4cdcb8b24",
    "match_by": {
      "data": [
        "1ab7edc96abaefb358b52c583048eaaeb8ea42609d096d6cddfafa02fa510c6a"
      ],
      "type": "Pubkeys"
    },
    "conf_settings": {
      "base_confs": 2,
      "base_nota": true,
      "rel_confs": 5,
      "rel_nota": false
    },
    "base_orderbook_ticker": null,
    "rel_orderbook_ticker": null
  }
}

Response (error)

{
  "error": "rpc:278] utxo:884] BASE balance 12.88892991 is too low, required 21.15"
}

On this page

sell