Relayed prices
A relayed price is a price of a finished stretch of the chain, computed by a fixed rule, signed by Sagitta’s price signers and posted on chain. Stock token markets read relayed prices, and so do memecoin markets on PumpSwap, Meteora DAMM v2, Meteora DLMM and Raydium CPMM: none of those keeps a record of past prices a program could read, and rule zero forbids reading a pool live (see Oracles).
Every relayed reading is public. GET /api/readings lists each one posted to the ring a market reads,
newest first, with its target slot, the price exactly as signed, its flags, the keys that signed it, the account that
posted it and the transaction that did, so anyone can recompute a pool reading from the chain, and check a stock
reading against Jupiter’s price for its slot.
Who signs
Section titled “Who signs”- The signer list. A reading counts only if it carries signatures from keys on the signer list in Sagitta’s core program, which holds up to 16 keys. Keys and the threshold change only through the 72-hour timelock, which is public on chain.
- How many sign. Each post needs signatures from as many listed keys as the threshold says, now 1, so one key’s signature is enough for a post.
- Removal. The guardian, a hardware key, and the sentinel, a key whose only powers are to remove a price signer and pause new buys, can each remove a signer at once. Only the timelock adds one back.
- What a signature covers. Each signed message names the cluster, Sagitta’s core program, the reading ring it is for and its kind, the account that will post it, and every entry: its target slot, its price and its flags. A signature is good for that ring and that poster only, and Solana’s Ed25519 precompile checks it in the same transaction as the post.
The rules core enforces
Section titled “The rules core enforces”Core takes a post only when every rule below holds, and refuses the whole post otherwise:
| Ring | A target is | It may be posted |
|---|---|---|
| A pool’s | The last slot of a 4 slots leader window | After its slot has passed, and at most 450 slots (about 90 seconds) after it |
| A stock token’s | The slot Jupiter reported the price for | At most 300 slots (about 60 seconds) after that slot |
| The burn’s grid ring | The last slot before a burn period opens | As a pool target |
- Written once. Each target is written once. A later post can’t change it, and a post can’t push out an entry it is adding itself.
- One ring per source. Every market on a pool or a stock token reads the same ring, which keeps its newest 64 readings. Keepers apply each reading, or copy it into its tickets, long before that many newer ones arrive.
- Landing order decides nothing. An earlier target that lands after a later one takes its place in order, as long as its window is open. A ticket is refunded only if its own reading never landed in time, never because another landed first.
- A bounded price. Prices are posted as ticks, and an out-of-range tick is refused.
Pool readings
Section titled “Pool readings”A ticket committed at a slot waits for the reading of the last slot of the first full leader window after it: its target, and its first reading after the commit. The reading is the pool’s price where the target window’s validator hands over to another, by this rule:
- At the end of the leader’s run. A validator can lead several windows back to back. The rule takes the validator that leads the target’s window and follows its run of back-to-back leader windows, from the target’s own, to its last slot. The value is the pool’s state after the last transaction at or before that slot, so a price counts only if it was still in place when another validator took over. Traffic after the run never counts, and a move undone before the run ends never reaches the reading. The reading still belongs to its target slot, and the public leader schedule shows where each run ends.
- Runs over the limit are refused. A run that goes on for more than 100 windows past the target’s own (400 slots, about 80 seconds) would leave too little time for a reading to post inside the target’s window, so the signers refuse that target: it is lost like any target left unposted, and its tickets are refunded whole.
- From finished blocks only. The signer reads blocks the network has finalized, and computes the price from the transactions that touched the pool, never from a live read. Anyone replaying the ledger gets the same number.
- By venue:
| Venue | The price after the last transaction that counts |
|---|---|
| PumpSwap | The quote vault plus the pool’s virtual quote reserve, divided by the base vault, from the balances that transaction left |
| Meteora DAMM v2 | The square-root price its newest swap left |
| Meteora DLMM | The active bin its newest swap or bin move left |
| Raydium CPMM | The reserves its newest swap left, net of the fees the pool holds aside: the fee-free reserves that swap’s event reports, moved by the trade at the fee rates of the pool’s config |
The price is the coin’s price in its quote, per base unit, as a tick. The signers post a pool’s first reading, the one a new listing starts from, only for its coin’s canonical pool (see Memecoin markets).
Stock readings
Section titled “Stock readings”A stock reading is Jupiter’s price for the token at a stated slot: the price per raw base unit
(usdPricePrescaled), and the slot Jupiter reported it for. The signer samples Jupiter itself, keeps a hash of
Jupiter’s answer with each reading it signs, and posts the reading within 300 slots of that slot, so every stored
stock price was at most about a minute old when it landed.
A stock ticket fills at the first reading whose slot is more than 300 slots after its commit, once no earlier reading can still land. Two flags travel with a stock reading, both signed:
- Closure. The first reading after an Ondo token’s closure of a day or more pays its move but fills no ticket (see Weekends and market hours).
- Step. A reading across a corporate action that the price per base unit did not absorb: on it a move of 2,000 ticks or more applies unpaid (see Splits and dividends).
On demand
Section titled “On demand”Readings are posted only when something needs them: the targets tickets wait on, a retiring market’s freeze reading, the first reading a new listing starts from, and the burn’s grid readings. There is no idle schedule. After a quiet stretch, the first reading carries every move since the last one, in one step.
Each ticket on a relayed market pays a 0.00002 SOL reading fee to the poster of the reading that fills it (see Fees and referrals).
Checks
Section titled “Checks”- The watchdog. Sagitta’s watchdog takes up each reading posted to a ring a market reads, once its slot is final. It recomputes a pool reading by the same rule from the ledger. It compares a stock reading with the record of Jupiter’s answer kept when the reading was signed or, failing that, with its own sample of Jupiter at the same slot, and checks the reading’s flags against the rules for its token. A reading posted by any account other than Sagitta’s own posters counts as a mismatch, whatever its value.
- What it can’t recompute. A reading the watchdog has nothing to compare with, or can’t read, goes to Sagitta’s operators, who check it by hand.
- The brake. On any mismatch the sentinel removes the keys that signed the reading and pauses new buys on every market. Cash-outs, executions, deliveries and claims keep working, and only the timelock adds a signer back or lifts the pause.
- Your own check. Every reading’s slot, price, flags and signers are on chain, and listed by
GET /api/readings.
When readings stop
Section titled “When readings stop”If no reading comes, tickets wait. A pool target left unposted past its window while a later one lands is lost, and its ticket is refunded whole, reading fee included. If a market’s oldest waiting ticket still has no reading 7 days after its commit, the market freezes and every holder cashes out at the frozen price (see Refunds); a retired market’s freeze reading gets the same 7 days from the retirement. Removing every signer works the same way: no new reading can post, so each relayed market freezes once its oldest waiting ticket, or its retirement, has waited 7 days with no reading. A market with nothing waiting when signing stops holds still, and freezes 7 days after the first commit made during the silence.