Skip to content

Order types: refund and cancel

An order’s funds come back to you in one of two ways: a cancel with your own key, or a refund after it expires. Neither reads the market, so no pause, upgrade announcement or wind-down can block them. Every order can be refunded; for routes, see the note under Cancel.

  • Who: only you, with the key that created the order.
  • When: any time before it’s fully filled.
  • Routes: in the app, Cancel appears for a route only once the DEX service supports cancelling routes; until then, My orders says so, and the refund after expiry is the way back.
  • What comes back: everything in the order box, including any proceeds a DCA or grid has kept.
  • What it costs: the miner fee only.
  • After a partial fill, cancel the new box that holds the rest (see partial fills).
  • Who: anyone may build the refund. Kadia’s keeper does it in practice, so you don’t have to sign anything.
  • When: once the order has expired unfilled.
  • What comes back: your tokens exactly as they were, and your ERG less at most your execution-fee cap. Kadia’s keeper charges only what the refund costs and gives the rest back.
  • Another refunder may keep up to your cap. That’s why the cap is there: it pays for refunds even if Kadia’s keeper stops.
  • Maker vault: withdraw with your withdraw key at any time. Every vault also shows “Withdraw without the service” (it needs a browser wallet; with ErgoPay, use Withdraw).
  • Firm offer: no cancel before the lock ends; withdraw from the block after it.

If the market’s contracts are upgraded, orders made for the old ones can’t be filled any more. Cancel them, or wait for the refund, and place them again. See if something goes wrong.

Technical details

Sources: kadia-dex docs/guide/how-it-works.md, docs/guide/fees.md, docs/guide/maker-vault-bots.md and the order-type decisions in docs/decisions/ at commit 7ce1595 (7ce159587dc8c0bd78d6a5fbe0f7f8e7dde3920e).