Skip to main content
The Jupiter Trigger Order API enables automated order types on Solana. Price orders execute a swap when a USD price condition is met (limit orders, take-profit, stop-loss). DCA orders split a deposit into recurring swaps on a schedule. Both share one vault, authentication, and deposit flow. Orders are stored off-chain and private by default, closing the most common MEV attack vector of visible pending orders. When an order triggers, Jupiter handles the swap: conversion, routing, and execution.

​
What’s New in V2

Trigger V2 unifies two products that previously had separate APIs: limit orders (Trigger V1) and DCA (the Recurring V1 API). Here is what changes if you are migrating from either.

​
Limit orders: Trigger V1 vs V2

Trigger V1 is not scheduled for deprecation, but all development is focused on V2; V1 receives critical-only updates.

​
DCA: Recurring V1 vs Trigger V2

DCA integrators are coming from the Recurring API, which is now unmaintained. What changes under Trigger V2:

​
Order Families

The API has two order families that share the same vault, authentication, and deposit flow.

​
Price Orders

Execute a swap when the USD price of a token crosses a threshold. See Create Order.

​
DCA (Dollar-Cost Averaging)

Split a single deposit into multiple swaps that execute on a fixed schedule. See DCA.

​
How It Works

Each wallet gets a single vault (a Privy-managed custodial account). When you create orders, tokens are deposited from your wallet into your vault. The vault holds funds for all your active orders.
  1. Authenticate: Sign a challenge with your wallet to receive a JWT token
  2. Set up your vault and deposit: Resolve your vault (or register one on first use), then craft and sign a deposit that funds the order
  3. Create an order: Submit a price order or a DCA order with the signed deposit
  4. Monitor: Track order state, fills, and events for price orders or DCA orders
  5. Manage: Update or cancel price orders, or cancel DCA orders
See Integration Flow for the full call sequence and how each call’s output feeds the next.

​
Base URL

All endpoints require an API key via the x-api-key header. Authenticated endpoints additionally require a JWT token via the Authorization: Bearer <token> header.

Get an API key

​
FAQ

For a price order that expired or that you no longer want, funds stay in the vault; retrieve them with the two-step cancel flow (initiate, sign the withdrawal, confirm). See Expired Order Withdrawal. For a DCA order, cancelling returns the unfilled remainder to your wallet; rounds already filled are not reversed. See Cancel a DCA Order.
Price orders can be updated in-place (trigger price and slippage) without cancelling and recreating. See Update an Order. DCA orders cannot be edited: to change a DCA, cancel it and create a new one.
V2 uses USD price triggers rather than pool rate triggers. When the price condition is met, the order executes a swap at the current market rate via Jupiter routing. The actual output depends on liquidity and slippage at execution time.
Price orders: 10 USD equivalent. DCA: at least 10 USD per round, so the total minimum is 10 USD × the number of rounds (a 2-round DCA needs at least 20 USD).
Open orders continue to be monitored and will execute normally. The JWT is only required for API calls (creating, editing, cancelling orders). When your token expires, re-authenticate to manage your orders.
A One-Cancels-Other order creates a take-profit and stop-loss pair that share one deposit. When one side fills, the other cancels automatically, returning unused funds to the vault.
A One-Triggers-One-Cancels-Other order has a parent trigger that executes first. Once the parent fills, it automatically activates a TP/SL pair (OCO) on the output tokens. If the parent expires or fails, the child orders are never created.
A DCA (dollar-cost averaging) order splits one deposit into multiple swaps that run on a schedule. You set the total amount, the number of rounds (2 or more), and the interval (1 minute to 1 year). Rounds can run unconditionally (time_based) or only within a price band (price_conditional). Each round must currently be worth at least 10 USD. See DCA.
Cancel it. Cancelling withdraws the unfilled remainder to your wallet; rounds already filled are not reversed. See Cancel a DCA Order.
A DCA order type that fills a round only while the trigger mint’s USD price is inside [minPriceUsd, maxPriceUsd]. While the price is out of band, the round waits and reschedules to the next interval. See Price-conditional orders.
For price orders: take-profit and buy-below orders use auto slippage via RTSE (Real-Time Slippage Estimator), and stop-loss and buy-above orders default to 20% (2000 bps) because execution certainty matters more when cutting losses. You can set a custom slippage. DCA orders have no slippage parameter: the keeper sets slippage per round from live market conditions at fill time.
The API accepts USD price triggers only (triggerPriceUsd). Market cap targeting is a convenience feature on the jup.ag frontend — it converts the market cap to a USD price before submitting to the API. To replicate this, divide the target market cap by the token’s total supply to get the per-token USD price.
No. V2 orders are stored off-chain and private by default. Order details (price, size, direction) are not revealed until the trigger condition is met and execution begins. In V1, pending orders were stored in on-chain PDA accounts, giving bots a roadmap to front-run profitable trades.
Not currently, and there is no timeline for adding them. There is no atomic workaround because the keeper executes the transaction and the order is opaque to integrators. The only option is to run a separate transfer transaction outside the order flow.