Trading on the site
sagitta.broker is a window onto the programs. The board, the feed and the leaderboards come from the API, which reads the chain for you. A portfolio, yours or anyone’s, is one call to the API: every holding at the board’s NAV, a few seconds behind the chain. Every number that has to be current is read from Solana itself, straight from your browser through the cluster’s public endpoints: the open market’s account, its reading ring and core’s settings, and, with a wallet connected, your own tokens of every epoch, tickets, SOL and market wallet. Every button builds its transaction with the SDK, checks it, simulates it, and only then hands it to your wallet.
The board lists stocks first, then crypto and memecoins (see Markets), and every market carries its badge:
Relayed price, Pool history or Chainlink. A stock’s tokens from different issuers sit together under their
ticker. The search at the top of every page finds a market by its ticker, its name, or any address it trades on: the
market itself, the coin or stock token, a memecoin’s pool or a Chainlink feed. Press / to search from anywhere.
Wallets
Section titled “Wallets”Connect offers every Solana wallet in the page:
- Browser wallets that follow the Wallet Standard, such as Phantom, Solflare and Backpack, appear on their own.
- On an Android phone, the Mobile Wallet Adapter connects the wallet app installed on the phone. On a phone with no wallet in the page, the menu offers to open the site inside Phantom’s, Solflare’s or Backpack’s own browser.
- A spare wallet in this browser (the burner): a key the site makes and keeps in your browser’s storage. It signs without asking, so use it for small amounts. You can export its key, and nothing else can recover it if the browser’s storage is cleared.
Simple and Pro
Section titled “Simple and Pro”The site has two views, switched by the Simple | Pro toggle at the top of every page. New visitors start in
Simple. Your browser remembers the choice, and a link ending in ?view=simple or ?view=pro opens that view.
| Simple | Pro | |
|---|---|---|
| Front page | What Sagitta is, how it works in three steps, one card per stock or coin (its price, the day’s move, where the money sits, and Up and Down), and the house token’s burn | The full board: the live totals, the trade feed, every market in one sortable table with its siblings, the runners and the house token |
| Market page | The price chart, where the money sits, and one trade box: pick Up or Down, enter an amount, and see what a 1% move up, a 1% move down, or no move would leave you with before you buy | The terminal: holders and live fills, the readings chart, the Take position card with Buy and Cash out, your positions, tickets and history, and the pots, rules, oracle and upkeep |
| Your positions | Each position with its value and gain or loss, and one Cash out for all of it | The full portfolio: P&L, older epochs, tickets, deliveries, the market wallet and referrals |
Both views read the same programs and send the same transactions through the same checks below; Simple shows less. Its outcomes assume one price update and count the 4% fee in and the 4% fee out. The rest of this page describes Pro.
What happens when you press a button
Section titled “What happens when you press a button”- Build. The SDK’s builder writes the exact instructions:
commit_mint,commit_redeem,convert,deliver,claim,executeand so on, with the market’s own version of the program. - Guard. The SDK’s account guard checks every account the transaction writes: each must be an address it derived, your own wallet or token account, or an account the ticket names. A recipient other than you is checked too, and one that could never sign to collect, such as a program or another market’s account, is refused before anything is signed.
- Simulate. The transaction runs once as a test. If the program would say no (under the minimum, buys closed, nothing owed), you see why in plain words and nothing is sent.
- Budget. It asks for the compute it used plus a margin, and a priority fee from the recent fees on the accounts it writes, never more than 100,000 lamports in all.
- Sign and send. Only a transaction that passed every check reaches your wallet. If the wallet changes it while signing, the site checks it again as if it came from elsewhere, and a changed transaction that fails is never sent.
- Confirm. The site waits until the network confirms it, then says what happened.
Committing
Section titled “Committing”The Take position card has two sides, Long · UP and Short · DOWN, and two tabs: Buy (commit_mint)
and Cash out (commit_redeem). Under the amount, the card shows everything the commit costs beyond it: the
ticket’s refundable deposit, a new token account’s deposit when you have none for that side yet, and on a relayed
market the 0.00002 SOL reading fee. A line names who the ticket pays, your wallet by default; open it to send the
shares or SOL to another wallet.
The smallest buy and the smallest cash-out come from the market itself, and when a market’s buys are closed the ticket says so; cash-outs always work.
A ?ref=<address> link names the referrer your first buy on a market binds. The referrer is optional and needs a market
wallet of its own; a link that names one without a wallet is ignored, and the buy goes ahead without a referrer.
Your tickets
Section titled “Your tickets”A ticket fills at the first reading after its commit (see
Delayed NAV), never at a price you could see. The ticket card lists yours on that market,
newest first, and your Portfolio (/me) lists them all:
| State | What the ticket shows |
|---|---|
| Waiting | What its reading is: the relayed reading of a slot, the pool’s next stored pair, or the next Chainlink round |
| Matured | ready: anyone can execute it. Execute settles it now and pays you its bounty |
| Settled | Filled or refunded, waiting for delivery. Deliver pays it out (anyone may), or Claim when it is yours to take |
| Delivered | What it paid: the shares and the price, or the SOL, and the deposit returned |
A relayed market’s page also shows where its reading stands and lists every posted reading, as
GET /api/readings gives them, with the price signers’ keys and the transaction that posted each.
Your market wallet
Section titled “Your market wallet”Executor bounties, reading fees and referral shares are credited to your market wallet, one small account in the market program that serves every market. The ticket card and your Portfolio show its balance with Withdraw, which pays all of it to your wallet. If you have none, the Portfolio offers to open one, with its refundable deposit. A credit to an account with no market wallet goes to the burn, so an execute from a wallet without one burns its bounty, and the site says so first.
When the chain doesn’t answer
Section titled “When the chain doesn’t answer”If the site can’t read the chain (every public endpoint fails, or asks it to slow down), the market page says live state is unavailable and shows the indexer’s last snapshot until the chain answers again. An endpoint that asks the site to slow down is left alone for as long as it asks, up to two minutes.
Older epochs
Section titled “Older epochs”When a side rolls to a new epoch, your old tokens keep their value. Your positions list them under Older epochs, each with what it converts to now and what that is worth at NAV:
- Convert swaps them for the current epoch’s tokens (
convert). Tokens many epochs behind take several transactions, each converting as far as one transaction holds, and the page sends them in order, numbered (1 of 3). - Cash out converts them and commits the cash-out, with the last convert in the same transaction as the cash-out.
The feed shows every roll as it happens: UP rolled to epoch 1.
Upkeep
Section titled “Upkeep”Every market page ends with an Inside this market panel, folded until you open it. It holds the pots, the rules,
the oracle and the upkeep calls, which are open to anyone; a link to #hood, #pots, #rules or #oracle opens it.
The useful calls pay a bounty.
- Execute settles matured tickets.
- Settle up (
poke) applies the reading that is ready and settles what it matures. - Deliver pays settled tickets out to their owners.
- Top up the pots adds SOL straight to a live side’s pot, shared by that side’s holders.
Listing
Section titled “Listing”List a market (/new) offers the stock tokens first, grouped by ticker. A token that already has a market gets a
sibling with pots of its own, and the token’s short link
still opens its lead market. A token on Sagitta’s allowlist with no market yet is found by its mint, from the search or
a runner card, and the page says whether it can list.
Below the stocks, List a coin takes a graduated memecoin’s mint, finds its canonical pool on PumpSwap, Raydium CPMM or a Meteora pool, shows what it costs to push that pool 1% once a market on it has measured it, and lists it. A source with no reading ring yet opens its ring first, in a transaction of its own, and the listing follows once the price signers have posted a fresh reading to it, within a couple of minutes. The lister pays the market’s deposits and its 0.000002 SOL seed (see Rent and deposits).