Kestrel Browser
User guide · section 7 of 17

Trading

Trading happens in the rail's TRADE pane, or with one press on a Hover card. Kestrel routes through Jupiter, simulates every transaction before it is signed, and signs on the device.

In the pane

Buy or Sell, the token's address in "Token", the amount, the slippage, and how it is sent. Once the token is known, its logo, name and symbol stand at the right of the Buy and Sell chips with a "Chart" link beside them that opens the token's chart on DexScreener in a new tab (the link is there even before the name is found, as soon as the address has the right shape), so a price is read on the chart and the trade set in the pane.

  • A buy offers 0.05, 0.1, 0.25, 0.5 and 1 SOL or a number of your own, starting from Settings > Trade > "Default amount" (0.1 SOL). The pane says what the wallet holds and offers "Buy max", which leaves room for the fees.
  • A sell offers 25, 50 and 100 percent of the holding or an amount.
  • Slippage is 0.5, 1, 3 or 5 percent, from the Slippage setting (1 percent); above 10 percent Shield warns about sandwich bots, and above 50 percent Kestrel refuses to quote at all.
  • A swap takes at most 50 SOL in.

The quote

The Trade pane: the amount, the slippage, the route, and what Shield checked above the quote.
The Trade pane: the amount, the slippage, the route, and what Shield checked above the quote.

What you receive, the least you receive, the price impact, the token's name and safety score, the route, and the Kestrel fee as a percentage and an amount.

Above the quote, "what Shield checked": simulated on mainnet, every program recognised, no drainer pattern, the output matches the quote. A check that could not run says so instead of showing a tick. "details" opens the transaction line by line.

A quote that finds Jupiter's budget spent (another program on your network asking Jupiter at the same moment) waits for the next slot, up to ten seconds, before it says "Jupiter is busy right now".

Signing

One button walks the steps:

  1. "Review this buy";
  2. "Reading and simulating";
  3. "Sign and buy · 0.1 SOL for at least N TOKEN";
  4. "Signing and sending";
  5. "Sent, confirming on chain";
  6. then "Bought" or "Not completed", with a link to Solscan.

The password is asked when the rule in section 6 says so. The native confirmation appears for a risky swap, for an overridden one, for 2 SOL or more, and when more than three signatures were asked for within a minute.

What Kestrel refuses

Bytes nobody quoted, critical Shield risk, a failed simulation, a spend above what the quote said plus a small fee budget, any other token leaving the wallet, an output below the quoted minimum, an expired quote, a locked wallet. High risk is the only state a person can override, with a checkbox that turns the button red.

Delivery

Through the RPC by default, with the same signed bytes re-broadcast for the first minute until the chain takes it, and confirmation watched for ninety seconds; if nothing lands the pane says so and nothing was spent.

A Jito bundle with a tip (0.0001 SOL by default, never above 0.01) is the other route, in Settings > Trade > "Send through". RPC is the default because a fixed tip bundle did not land in the real money test.

The fee

A plain SOL transfer to Kestrel appended to the swap: 0.25 percent on Free, nothing on Premium (section 8), taken from the SOL going in on a buy and from the SOL coming back on a sell. It is on the list of what the transaction does before you sign, to the last lamport. If the transfer would not fit in the transaction, the fee is dropped rather than the trade.

Under a quote the Trade pane says that holders of $KESTREL pay no Kestrel fee, with a link to the page that explains Premium.

From a Hover card

Three one press buys (0.1, 0.5 and 1 SOL by default, set in Settings; each capped at 1 SOL), "ALL" which buys with 95 percent of the SOL in the wallet and asks on the card itself when that is 2 SOL or more, and sells of 25, 50, 75 or 100 percent of the holding.

The amounts come from the wallet, never from the page. A press in the first 600 ms after the card appears is ignored, at most three trades in ten seconds are taken, and card trading is Solana only.

A trade the card cannot finish (a locked wallet, a Shield flag, the password rule, no holding) lands in the Trade pane with the reason and the quote.

Orders: buys and sells that fill by themselves

An order is a buy or a sell you set now that Kestrel fills later, when the price gets there, while Kestrel Browser is open. The Trade pane's "Order" tab holds the form; the Hover card's ORDER button opens it with the token filled in. The wallet must be unlocked to arm one.

The Order tab: a buy of 0.005 SOL when the market cap is at or below 120K, with a take profit riding on the fill, the slippage and expiry chips, and the guards folded under them.
The Order tab: a buy of 0.005 SOL when the market cap is at or below 120K, with a take profit riding on the fill, the slippage and expiry chips, and the guards folded under them.
  • A buy at a price: "Buy with" an amount of SOL "when market cap is at or below" a number of dollars, typed as you like ("120k", "1.2M", "120,000"); the amount is read back in words beside the field with the price it means. The two small chips by the label switch the target to a price if you think in prices; the market cap it means is read back the same way. Two options under it ride on the fill: "then sell half of what the wallet holds at N x the fill price" and "and sell all the wallet holds at N x the fill price" (a stop). A share always counts everything the wallet holds of the token, not only what the order bought.
  • A sell at a price, for a token the wallet holds (the form opens on this side when the wallet holds the token): Take profit ("when market cap is at or above"), Stop ("at or below"), or a Trailing stop ("when the price falls from its peak by" a percent), each selling a share of the holding (50 percent by default).
  • Slippage 1, 3, 5 or 10 percent and Expires in 1 h, 6 h, 1 d or 7 d, starting from the Orders settings (3 percent, 24 hours). Behind "Guards and the away rule": the liquidity floor, the price impact cap, the away limit, and whether a stop crossed while away sells at once (section "Away" below).
  • A line under the form says whether the order would fill at once at the current price. The system's window asks once, when you press "Arm this order", and reads every leg back in words: what, how much, at what price, within how many hours, with which limits, and the Kestrel fee of your plan on each fill. No question is asked at the fill. Once armed, the pane reads the order back in words, says how long it runs, and offers "See it in the Wallet pane"; the token's own orders are listed under the form from then on. An order whose liquidity floor is above what the pool holds now is refused at the arm, since it could never fill: lower the floor under "Guards and the away rule".

How a fill is decided:

  • Kestrel reads the price every three seconds while an order is armed.
  • A level is a touch only when the price comes to it from the other side: a buy at $1 fires when the price has been above $1 and then is at or below it in two readings in a row. The price at the arm counts as seen, so a buy armed with the price above its level fills when the next two readings are at or below it. A reading more than a minute after the last one starts the memory again, and so does a resume or a restart: a price already past the level is then no touch until it has been seen on the other side again.
  • A condition that already holds when you arm fills at the first reading: the form says so under the target while you type, and the window says so again, with the current price, before you arm.
  • A take or stop given as a multiple takes its price from what the buy really paid: the SOL given against the tokens received, at SOL's price at that moment (the market's reading stands in when SOL's price is not known just then). A trailing stop follows the highest price it has seen since it was armed.
  • At the fill the guards are checked first: the pool's liquidity against the floor (the setting or half of what it held at arming, whichever is higher), the token's mint and freeze authorities against what they were at arming, the quote's price impact against the cap (a stop or a trailing stop is "get out whatever it costs": only the slippage bounds it), the wallet's balance. Then the fill goes the way of every trade: Jupiter's quote, Shield, the simulation, the outcome check, the signature on the device, the send, the fee of section "The fee". The leg counts as filled only when the chain says the transaction landed; the list says "sent, waiting for the chain" meanwhile. A passing failure (the quote not answering, a simulation that did not pass, a transaction the chain refused because the price moved past the slippage, or one the network did not take) is tried again after a short wait for as long as the condition holds, about seven minutes in all, the list saying "trying again" with the reason; only then does the order pause and say why. A flag of Shield's or a failed guard pauses it at once.
  • A sell that sold everything ends the other sell legs; an order with no leg left is done. Each fill is an alert of the Trades kind with its Solscan link.
The Wallet pane with an order armed: the token, the state, the latest price, the leg with how far it has to go, and pause and cancel.
The Wallet pane with an order armed: the token, the state, the latest price, the leg with how far it has to go, and pause and cancel.

The Wallet pane lists the wallet's orders under ORDERS, below the tokens, with their state (armed, paused, waiting for your review), the latest price, how far each leg still has to go, "touched" when a level was reached once, and pause, resume and cancel. Orders armed on the device's other wallets are listed under them with their wallet's address, so nothing armed is out of sight. The last five ended orders stay under them with their fills, each with a "delete" that takes it off the list; the Trade pane's Order tab lists the token's own orders under its form the same way. The wallet chip in the toolbar carries a small dot while an order is armed. A cancel or a pause that comes while a fill is on its way stops it before the signature; a fill that had already gone out is recorded on the order as you left it.

Away: an order needs Kestrel Browser open and the computer awake (Kestrel keeps it from idling to sleep while an order is armed; a closed lid or a quit still stops it). After a quit, a sleep or a long loss of prices:

  • if the gap was shorter than the away limit (15 minutes by default, set per order), the order waits paused for you to unlock the wallet and press resume, and starts cold: nothing it saw before the gap counts as a touch; an alert says how many orders stopped with the restart;
  • if the gap was longer, the order waits for your review and says how long Kestrel was not watching; resume, change or cancel it. The same review comes while the app is open when no reading arrived for longer than the away limit: the computer slept, or the market could not be read. A stop crossed while away does not sell on its own unless the order was armed with "if my stop was crossed while away, sell at once when the guards pass"; then the resumed stop sells at the first reading, once the guards pass.
  • An order that ran out of its time ends as expired and tells you.

Locking: the wallet's lock (section 6) leaves armed orders running; the pane says so. "Lock everything", shown beside it while an order is armed, locks the wallet and pauses every order until you unlock and resume. Quitting Kestrel Browser pauses them the same way, and the update's restart dialog says so when an order is armed. Removing a wallet from the device ends its orders.

Which tokens: any Solana token DexScreener or Jupiter lists with a price (DexScreener first; Jupiter stands in for a token it does not price, and the orders list says "prices from Jupiter now" on a leg whose prices changed source; a change of source counts as a gap, so nothing fires on it). A token still on pump.fun's bonding curve can be ordered (Jupiter fills through the curve); it has no pool and no liquidity figure, so the window says the liquidity floor applies only once it has migrated, and a buy on the curve carries no Kestrel fee (the transaction has no room for it). A migrated token, a tiny pool, a big cap and a Token-2022 token all take the same path; a tiny pool under your floor is refused at the arm with the way out, and a fill whose quote would move the price past your impact cap pauses instead of filling, for a take profit as for a buy; a stop sells on.

Free keeps one open order per wallet with up to two legs, so a buy carries its take profit or its stop, not both; Premium keeps twenty with up to ten legs each (section 8), the buy with both and more. The form says so the moment a plan's limit is crossed (both boxes ticked on Free, or an order already open): a box under the legs names the plan and the limit in words, what Premium keeps, how much $KESTREL to hold in one wallet for it and how far you are, with the link to the Premium page; the arm button waits until the order fits. Orders live on the device and are read by nobody else.