Positions in your wallet (opened yourself, imported, or copied from a card or smart money) can be handled in Alokumi with one click. All of these are signed by your wallet: Alokumi doesn’t hold these positions and has no signing rights over them.
How each transaction goes out
- You click an action. The server reads the on-chain state (pool, position, balances) and builds an unsigned transaction.
- The server simulates it first. If the simulation fails (not enough balance, the price moved, an account in the wrong state…) you aren’t asked to sign, and the dialog says why.
- You check it in your wallet and sign. Make sure what the wallet shows matches what you clicked on the page.
- After sending, the dialog waits for on-chain confirmation, then records it on your position.
Quotes refresh every 20 seconds; if a refresh hasn’t succeeded for over 60 seconds you can’t sign until you click Refresh now. Only the wallet holding the position can sign; once that wallet is unbound from your account, Alokumi stops building transactions for it.
If a transaction’s status is unknown (sent, but no result), the dialog gives you the signature link and the button becomes Close (the transaction won’t be cancelled). Check it on Solscan first; don’t sign another one, or you may do it twice.
Where the actions are
- The ⋯ menu at the end of each row in the positions table: Claim fees, Reset range, Close, Details;
- the buttons on the position page;
- position alerts in To do (Exit, Claim, Reset range) and the buttons in Telegram alerts, which open the same dialog.
Agent-managed positions aren’t handled here: the Agent claims, resets and closes them by your rules, so these items are greyed out with Managed by the Agent.
Exit
Withdraws all liquidity, claims fees and closes the position account (the rent comes back to your wallet).
You can turn on Swap back to … in the same transaction to swap 98% of the other token back to the quote token through Jupiter (2% is left for price movement); if any step fails, the whole transaction rolls back. Swap-back isn’t offered when its price impact is above 3%.
Claim fees
Claims accumulated fees to your wallet and leaves the position as it is. The button is greyed out when there’s nothing to claim.
Reset range
Once price leaves the range, the position is all one token and earns no fees. Resetting the range = exiting the old range, then opening a new one. It takes two steps and two wallet signatures:
- Exit the old range: all liquidity and fees return to your wallet and the position account closes. No swap in this step.
- Open the new range: after the exit confirms, open a new position with the returned tokens. By default it’s as wide as the old range and centered on the current price; shape, side, bounds, amount and slippage are adjustable. A missing token is swapped in the same transaction as the open. The amount can’t exceed 105% of the exited value.
The new open can only be built after the exit has landed, so it can’t be signed in one go. If you close the dialog before step 2, you have 24 hours to come back to the old position’s page and click Open a new range. The new position keeps the old one’s rules and alert settings.
Open with your wallet
An opportunity card in Watch mode (Open with wallet) and an open position on a smart-money wallet page (Open this with my wallet) open the same dialog:
- The dialog shows the price chart and the range from the card (or their position). After you connect your Solana wallet, the server recomputes the range at the current price, builds the transaction and simulates it.
- Confirm the parameters:
- Range, shape and side: Spot / Curve / Bid-Ask, Two-sided / Below price / Above price, and the distance of each bound from the current price (lower bound up to 95%, upper up to 500%). When copying smart money it’s prefilled with their range; if their range sits entirely on one side of the price, it becomes single-sided.
- Amount (USD);
- Max slippage (%), up to 10%;
- Pay with: Auto (swap whatever is missing), a specific token from your wallet, or Don’t swap (existing balances only).
- Review the quote: the current price against the price when the card was created, how much of each token goes in and your wallet balances, and the cost breakdown (position account rent, refunded on close; new bin array rent, not refunded; new token account rent; network fee; Total SOL needed). Problems show here, for example not enough SOL, a failed simulation, a transfer tax or a price far from the market.
- Tick the risk acknowledgement and click Sign in wallet and open (or Sign in wallet: swap and open when a swap is needed).
- When a token is missing, the swap (through Jupiter) and the open go in the same transaction; if any step fails the whole thing rolls back, so you never end up “swapped but not opened”. No transaction is offered if the swap’s price impact is above 5%.
- Multi-leg plans (a wide range split into legs) are signed in one go, then sent one by one: a swap, if needed, goes first; each transaction waits for the previous one to confirm, and if one fails the rest aren’t sent.
- After the open confirms, the paying wallet is bound to your account automatically and the position is tracked. If you see The open succeeded on-chain, but we couldn’t record it, click Retry recording; don’t open again.
Cost
Exiting, claiming and opening itself carry no Alokumi fee. Only when we swap for you (a missing token on open, swap-back on exit, topping up for a range reset) do we charge 0.2% of the swap, and only when one side of the swap is SOL, USDC or USDT; it’s shown in the dialog as a platform fee and already included in the quoted output. On-chain rent and network fees are paid by your wallet as usual. See Fees.