Skip to main content

marketplace_cancel_offer

Withdraws an offer previously published by this wallet from the marketplace by broadcasting a signed cancellation transaction.

Request​

{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "marketplace_cancel_offer",
  "params": {
    "tx_id": "c1f6a8d9037e5b1c2a4d6e8f0123cb0d0a1a4e1c6f6a2c1c9e6b8f0a3d7e4b25",
    "no": 0,
    "fee": 10000000000
  }
}

Request parameters​

  • tx_id - string; hex-encoded hash of the transaction that currently carries the offer being cancelled. This is the tx_hash reported for the offer by marketplace_get_offers_ex; if the offer was updated at least once, use the hash of the most recent update transaction.
  • no - unsigned int; zero-based index of the offer inside that transaction, matching the offer's index_in_tx.
  • fee - unsigned int; fee paid for the cancellation transaction, in atomic units (1 coin = 10^12 atomic units).

The wallet authorizes the cancellation by signing it with the key derived for tx_id and no, so only the wallet that published the offer can withdraw it. The fee already spent on publishing the offer is not refunded.

Response​

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "tx_hash": "8f0a3d7e4b25c1f6a8d9037e5b1c2a4d6e8f0123cb0d0a1a4e1c6f6a2c1c9e6b",
    "tx_blob_size": 1874
  }
}

Response information​

  • tx_hash - string; hash of the broadcast cancellation transaction.
  • tx_blob_size - unsigned int; size of the broadcast transaction in bytes. The offer disappears from marketplace listings once this transaction is confirmed.