You place market and limit orders on Trade, on any token Jupiter routes, paired against SOL and against USDC. Each order is signed by your account’s auth key and sealed to the Coprocessor in your browser, with one press and no wallet prompt.
Pick a market#
Press the pair at the top left of Trade, base/quote, to open the market picker; /trade opens on SOL/USDC. Type in “Search a token or paste its mint”, and narrow the list to one quote asset with All, SOL or USDC. Markets for assets you hold come first, marked Held, then the markets you opened recently.
Every token Jupiter routes is listed twice, once against SOL and once against USDC; the quote asset is the one prices and fees are counted in. A token the Pool has not admitted yet is tagged Enters the Pool on first order: its first order requests admission, which the protocol pays. Picking a market opens it at /trade/<pair>.
The market bar#
| Shows | What it is |
|---|---|
| The mid | The price orders cross at, in the quote asset: quote · Pyth mid with its confidence interval (±n%) where the token has a Pyth feed, Jupiter price otherwise. “No price for this pair yet” when there is none. |
| The Crossing clock | “An order now makes the next Crossing”, beside a ring with the Pool’s drop breathing inside (Crossings and fills). |
| Fee | The fee rate φ, 0.10% (Fees). |
| The chart | “Price, from GeckoTerminal’s public candles” at 1m, 5m (the default), 1h or 1d, with the live mid at its right end. A token with none reads “No public candles for this token’s pool yet.” |
Place an order#
Choose the side and type#
Buy or Sell the base asset, then Market or Limit. The ticket shows the current mid beside the type, as Mid price.
Enter the size#
Size is in the base asset by default. Press the unit beside the field to enter it in the quote asset instead; a quote size becomes the largest base size it pays for, fee included for a buy. Above the field, Available shows what the order can draw on: the balance of the asset it spends (the quote for a buy, the base for a sell) less what your open orders hold. 25%, 50%, 75% and Max fill in that share of what the balance funds.
Set the limit and its time (limit orders)#
Limit price is the worst price you accept, in the quote asset; the field shows the mid until you type. Rests for sets how long the order stays in the Pool: 30 s, 1 min (the default), 5 min, 1 h or 1 day.
Set the slippage (market orders)#
Max slippage is the furthest from the mid a market order may fill: 0.5%, 1%, 3% (the default), 5% or 10%.
Read the estimate#
Costs about (or Gets about for a quote size) converts the size at the mid or your limit. Fills at says how the order fills: “The mid, routed within n%” for a market order, with your max slippage, “Your limit or better” for a limit. Fee at rate shows the estimated fee in the quote asset.
Press once#
The button names the order, Place buy size unit or Place sell size unit, in the unit the size is entered in. The browser builds the Intent, signs it with the auth key, seals it to the enclave’s attested key and sends it to intake. The ticket shows the order’s state under the button, and the Placed here tab lists it.
Market orders#
A market order is an Intent with a protective limit in place of a chosen one: the app sets it from the mid and your max slippage (Market and limit). No fill passes that limit. Before placing it, the app reads the route bound Jupiter quotes for the order’s exact size and side, and places nothing while that bound is wider than your max slippage. The order expires about one minute after it is placed, and whatever has not filled by then is released.
A market order needs a valid mid: one with a price, no older than 75 seconds and, for a Pyth mid, a confidence interval no wider than 25 bps and a price within 25 bps of Jupiter’s live price (Clearing at the mid). While the mid fails one of these, a banner over the market says the pair isn’t crossing (see below), the pair’s limit orders rest, and the ticket holds market orders back: its button reads “base/quote isn’t crossing right now. Place a limit order.”
Limit orders#
A limit order crosses at the mid whenever the mid is at or better than its limit, and routes only when its limit also clears the Residual’s worst admissible price. What it cannot fill rests across Crossings until its time runs out, so one limit order can fill in parts over several Crossings (Crossings and fills).
Open orders and cancel#
The Open tab lists your resting limit orders, recovered from the enclave on any device: the side and pair, what is Left, the Limit, the State (“Resting” or “Partly filled, resting”) and the slot under Expires at slot. Press Cancel on a row, or on a resting order in the Placed here tab. The app seals a cancel Intent that burns the order’s nonce, so what remains of it never fills; nothing lands on chain. The row reads “Cancelling at the next Crossing” until that Crossing takes the cancel, then the order turns Cancelled.
Order states#
The Placed here tab and the ticket name each order’s state with a mark drawn from the drop.
| Mark | State | What it means |
|---|---|---|
| Ring around a drop | Sealing | The browser is building, signing and sealing the Intent. |
| Ring around a drop | Sealed, with the Coprocessor | The enclave holds the Intent. |
| Breathing drop | Waiting for Crossing k | The order is in the batch of Crossing k; it reads Waiting for the next Crossing until the enclave names k. |
| Solid drop | Filled at Crossing k | Filled in full: the share at the mid, the average price and the fee show with it (Reading a fill). |
| Dashed ring | Resting until its limit is met | A limit order waiting across Crossings. |
| Half drop | Partly filled at Crossing k | Part filled; the rest keeps resting. |
| Faded drop | Expired | Its time ran out; what remained unfilled is released. |
| Empty ring | Cancelled | Cancelled by your cancel Intent. |
| Ring in rose, with a mark | Rejected | Refused by the enclave, with the reason in words. |
| Ring in amber, with a mark | Kept on this device | Not taken by intake; the message beside it says why, with Retry on its row in the Placed here tab. |
A rejected order carries one of four reasons:
| Reason | The app says |
|---|---|
| Unfunded | “Your available balance could not fund it.” |
| Stale price | “The mid was too old to cross at.” |
| Bad limit | “Its limit price could not be met in its bound.” |
| Below the minimum | “It was smaller than the least this market takes.” |
Nothing about a rejected order reaches the chain, and its reason returns to your account alone.
What the ticket asks for first#
| You have | The ticket shows | Next |
|---|---|---|
| The Escape open | “Trading is closed while the Escape is open” and Open the Escape panel | Take out your balance (The Escape). |
| No wallet connected | “Connect a wallet to trade”, with your wallets | Pick one (Your account and keys). |
| A wallet, no open account | “Open your account” and Open account | Sign the account message once. |
| An open account, no balance | “Deposit to trade”, “Fund the account once; every market draws on it.” and the Deposit form | Deposit (Deposits). |
When the app answers#
With a size entered, the place button carries the line that holds an order back.
“No price for this pair yet. Place a limit order.”#
The pair has no mid. Switch to Limit and set your price.
“Enter a limit price”#
A limit order has a size and no limit yet. Type the worst price you accept.
“The smallest order is n base.”#
The size is under one denomination unit of the base asset, the least the Coprocessor takes. Raise the size.
“Your available asset can’t fund this order.”#
The order needs more than its available balance, the fee included for a buy. Lower the size, cancel an open order that holds the balance, or deposit.
“The intake is unreachable. Your sealed order is kept on this device.”#
The order is sealed and kept in the tab, shown as Kept on this device. Retry sends the same sealed bytes, which intake answers once, and the order keeps its row.
“Admission was requested. Retry when the asset is admitted.”#
The market’s token was not admitted yet. Under the ticket, “base enters the Pool with its first order; the protocol pays its admission.” Pressing place requests the admission, the ticket adds “base enters the Pool with this order; the protocol pays its admission.”, and the order shows Kept on this device with this line. Press Retry once the token is admitted; it builds and seals the order again.
A banner over the market speaks for the whole pair.
“base/quote isn’t crossing right now: its Pyth mid is n s old. Market orders wait for a valid mid; limit orders rest until it crosses again.”#
The Pyth mid is older than 75 seconds. Within 75 seconds the banner reads “off the live reference” in place of the age: the mid is more than 0.25% from Jupiter’s live price, Jupiter’s price could not be read, or the confidence interval is wider than 0.25%. The pair skips Crossings until its mid passes again. Wait for it, or place a limit order, which rests until then.
“The mid’s confidence is ±n%, wider than the 0.25% a Crossing clears at. Market orders wait for it to narrow; limit orders rest until it does.”#
The Pyth mid’s confidence interval is wider than 0.25%. Wait for the interval to narrow, or place a limit order, which rests until then.
“This route needs n% slippage, more than you set.”#
Shown beside Max slippage when Jupiter’s route for this size needs more than you set. Nothing was placed and the size stays. Choose a higher max slippage or a smaller size, or place a limit order.
“The market is out of reach.”#
The market bar could not be read. The banner adds “Showing the last mid read.” with Retry; the ticket stays usable with that mid.
The SDK places the same orders with trade and cancels them with cancel.