Skip to content

Refunds

A ticket only ever fills at one reading: the first reading after its commit (see Delayed NAV). If that reading is lost, the market does not fill the ticket at some other price. It refunds it, whole and with no fee:

Ticket Refund
Buy Your SOL back, with its reading fee
Cash-out Your side tokens back, in their own epoch, with the reading fee

A refunded ticket never fills at any NAV. Refunds go to the wallet that committed and paid, and nothing is held back.

Market Its reading is lost when
Memecoin, relayed price The reading of its target slot wasn’t posted within that target’s 450 slots (about 90 seconds) window, and a later target’s was, as happens to a target whose leader’s run goes on past 100 windows. A ticket is refunded only once its own window has closed, never because another reading landed first
Stock token Readings are kept in a ring of the 64 newest per token, and the ring has moved past the ticket’s threshold before the ticket took its reading. A stock reading that simply hasn’t come yet keeps the ticket waiting
Memecoin, pool history Raydium CLMM’s own ring of 100 observations has turned over past the ticket’s commit before anyone took or kept its pair: at the pool’s fastest, about 25 minutes of nonstop trading with nobody executing
Chainlink A round that landed after the commit, and that could have been the ticket’s own, was never copied into the market before a later one was

Relayed readings are signed by Sagitta’s price signers, and every posted one is listed by GET /api/readings, so a lost target shows as a gap there.

  • Per ticket. Only the ticket whose own reading is gone is refunded. The tickets behind it are checked on their own readings and fill on them as usual.
  • Keeping readings. Anyone can call secure, which copies a waiting ticket’s reading into the ticket as soon as its source holds it. Once copied, no turnover of a ring and no outage can take it away. Keepers secure while tickets wait.
  • Chainlink markets copy every round in. A keeper copies each new round into every Chainlink market that has a ticket waiting, so the round a ticket needs is in the market’s own log.

A market freezes for good in three ways:

Case It freezes at Buys still waiting Cash-outs still waiting
Silence. The oldest waiting ticket still has no reading 7 days after its commit: a stock token whose price stopped, a quiet pool, a feed that stopped, or a reading that was lost Its current price Refunded whole, reading fee included Filled at the frozen price, less the 4% fee
Loss run. Readings keep being lost, each at most 6 hours after the one before, for 7 days The last price applied, once every ticket committed before the freeze fell due has settled on its own reading Committed before: filled at its own reading, or refunded if that was lost. After: refunded whole Committed before: filled at its own reading, or refunded if lost. After: filled at the frozen price
Retirement. The market was retired: its version or the market itself was sunset, its coin was blocked, its quote or stock token delisted, or its pool replaced by a pin The first reading that would fill a ticket committed at the retirement Each one committed before the retirement fills at its own first reading, at the latest the freeze reading; a buy whose reading is lost is still refunded Those committed before the retirement fill at their own first readings; those after it fill at the frozen price

While a loss run is open, a market applies no reading that no ticket is waiting for. A frozen market reads no price again, takes no buys, and takes cash-outs of any size, each at the frozen price less the fee, with no reading fee.

A retired market’s freeze reading can itself be lost. The market then moves its freeze to a reading taken after that moment, never one already posted, and freezes for silence if none comes within 7 days of the retirement.

A memecoin market whose two sides are empty, with no ticket waiting and nothing committed or settled for 30 days, can also be frozen by anyone (retire_idle), so that it can close and return its deposits to the burn vault. Stock token and Chainlink markets never freeze this way.

If a ticket at the head of the queue has been due for 72 hours and still hasn’t settled, which only an unforeseen fault could cause, anyone can call quarantine_head. It turns that ticket into a whole refund (its reading fee goes to the poster if its reading arrived) and moves the queue past it, so no ticket can hold up the ones behind it.

A buy is also refunded, whole, if its net amount would buy no tokens at all, or if it goes into an empty side and would leave that side with less than 0.001 of a token. A buy of at least the 0.01 SOL minimum always revives an empty side, and the site checks these cases before you commit.

A buy that would roll its side to a new epoch waits until the last roll’s old epoch has been filed away by prepare_epoch. If cash-outs of that old epoch are queued behind the buy, the buy is refunded at once instead, so the queue keeps moving.

  • Not a cancel. You can’t ask for a refund. Tickets have no cancel; a refund happens only in the cases above. A pause, a sunset or a retirement never refunds a ticket that already matured.
  • Not a loss of your position. A refunded cash-out gives your side tokens back, still a share of their pot, and you can commit again. If its side rolled to a new epoch meanwhile, you get the same old-epoch tokens back, still worth what they were.
  • Not a size limit. A buy is never refunded for making its side’s token count too large: the side rolls to a new epoch instead.

A refund is settled into its ticket like a fill: the SOL or the tokens are owed to the wallet that committed, and a delivery pays them out and returns the ticket’s deposit. Anyone can deliver, keepers do within moments, and the committer can always take them with claim. A refunded cash-out’s tokens are minted back into the committer’s token account for their epoch.