Docs
Getting started
- Sign in. Connect a Solana wallet such as Phantom, Solflare or Backpack and sign a short message. Signing costs nothing and moves nothing. The signature is valid for five minutes and keeps you signed in for 30 days.
- Fund your Trigger wallet. On first sign-in Trigger creates a wallet just for your rules. Its address and QR code are on the Wallet tab. Send it the tokens your rules will swap, plus about 0.01 SOL for network fees.
- Write a rule. On the Rules tab, fill in the blanks of the sentence and press Arm rule. From then on Trigger watches for you.
Your Trigger wallet
Rules have to execute while you’re away, so they can’t wait for you to approve a transaction. Instead, each account has its own Trigger wallet, and Trigger holds its key. That makes the Trigger wallet custodial: deposit only what you want automated. Your own wallet is never touched and never asked to sign anything but the sign-in message.
The Wallet tab shows the deposit address, every token the Trigger wallet holds and its value in US dollars. Any Solana token can be deposited, including Token-2022 tokens.
Price rules
When SOL goes below $110, swap 50 USDC for SOL.
- The watched token can be any token Jupiter prices. Its price is Jupiter’s live price in US dollars.
- Below or above. Click the word to switch. “Below $110” fires at $110 or lower; “above” fires at the price or higher.
- The swap is a fixed amount of one token for another. The watched token doesn’t have to be in the swap: you can watch SOL and swap USDC for JUP.
- One shot. A price rule fires once and is then marked executed. Re-arm it to run it again.
While a price rule is armed, its card shows a gauge of how far the price is from the trigger. The gauge fills as the price closes in and is full when the rule fires.
Deposit rules
When USDC arrives, swap it for SOL.
Click “below” twice in the rule sentence to get “arrives”. A deposit rule swaps whatever arrives in your Trigger wallet, every time something arrives. Use it to convert payments, payouts or rewards the moment they land.
- It stays armed. After each swap the rule goes back to watching for the next deposit.
- Only new arrivals count. What the wallet already held when you armed the rule is left alone, and so is anything that arrives while the rule is paused.
- Deposits under $1 are ignored, so dust sent to your wallet can’t drain it through swap fees.
- One deposit rule per token. Two rules on the same token would both try to swap the same deposit.
- Swap output isn’t a deposit. If another rule swaps into USDC, a USDC deposit rule won’t swap that USDC again.
- Withdrawals are fine. Taking tokens out doesn’t confuse the rule. The next deposit is still swapped in full.
- SOL deposits keep 0.005 SOL back for fees, so a SOL rule never empties the wallet.
If a deposit swap fails, the rule stops and shows why. Re-arming it starts from the current balance, so the deposit that failed stays in the wallet. Swap or withdraw it yourself.
Managing rules
- Armed
- Checked every ten seconds. Pause or cancel it at any time.
- Paused
- Not checked. Resume puts it back exactly as it was; a deposit rule resumes from the current balance.
- Executing
- A swap is in flight. It can’t be paused or cancelled until it finishes.
- Executed
- The swap confirmed. The card shows what went in, what came out, and a Solscan link.
- Failed
- The swap didn’t go through. The card says why.
Re-arm on an executed or failed rule arms a fresh copy and keeps the original in your history. Cancel removes an armed or paused rule entirely. The History tab lists every run of every rule, with links to each transaction.
How a rule executes
- Every ten seconds, Trigger fetches live prices from Jupiter for every armed rule and checks them one at a time.
- When a rule’s condition is true, Trigger marks it executing, so it can never fire twice.
- It checks that the Trigger wallet holds enough of the token and enough SOL for fees, and fails with a clear reason if not.
- It gets the best route from Jupiter, signs the swap with your Trigger wallet and sends it.
- It waits for the transaction to confirm on-chain, then records the result.
If Trigger restarts while a swap is in flight, it can’t know whether the swap landed. It marks that rule failed rather than retrying, so it never buys twice. Check the wallet on Solscan before re-arming it.
Withdrawals
From the Wallet tab you can withdraw any token at any time. Withdrawals always go to the wallet you signed in with. There is no field for another address, so even someone who stole your session couldn’t send funds elsewhere.
- Withdrawing all your SOL sends the balance minus the network fee.
- While the Trigger wallet holds other tokens, 0.005 SOL stays behind, because withdrawing those tokens needs SOL for fees. Withdraw the tokens first, then the last of the SOL.
- If your wallet has no account for a token yet, the withdrawal creates one, paid from the Trigger wallet’s SOL.
Fees
Trigger takes no fee. You pay only what Solana and the swap route charge, from the Trigger wallet:
- The network fee on each swap or withdrawal, plus a priority fee on swaps that adjusts to how busy Solana is.
- About 0.002 SOL of rent the first time the wallet receives a new token.
- Whatever the route’s pools charge, which is already included in Jupiter’s quote.
Keeping about 0.01 SOL in the Trigger wallet covers many swaps.
Security
- Sign-in uses a signed message, never a transaction. Trigger never asks your own wallet to approve a transfer.
- Each Trigger wallet’s key is encrypted with AES-256-GCM before it is stored. The encryption key is kept apart from the database.
- Withdrawals can only go to the wallet you signed in with.
- Sessions are random tokens in a cookie your browser keeps from scripts. Signing out ends the session on the server.
Custody still means trust: if Trigger’s servers were compromised, funds in Trigger wallets could be at risk. Keep in it only what your rules need.
Limits
- Prices are checked every ten seconds, so a spike shorter than that can be missed.
- Swaps allow up to 1% slippage. In a fast market the price you get can differ from the trigger price.
- A rule on a token Jupiter can’t price waits and never fires.
- Rules can swap only what the Trigger wallet holds. Trigger never borrows or uses leverage.
- Trigger runs on Solana mainnet only.