# Kokoah > Kokoah is a web app for trading Hyperliquid perpetual futures and spot markets without giving up your keys: simpler than an exchange screen, with protective automation, alerts, a Telegram bot and an AI assistant that never trades on its own. This file is the whole of Kokoah's public documentation in one plain-text page, for AI assistants and search tools. The same content is on the website at https://kokoah.com/docs. ## About Kokoah - **What it is:** a non-custodial trading app for [Hyperliquid](https://hyperliquid.xyz), a decentralized exchange for perpetual futures and spot tokens. Orders go straight to Hyperliquid; Kokoah never holds user funds. - **Keys stay with the user:** people sign in with their own wallet (browser wallet, WalletConnect) or create an email wallet with email, Google or a passkey. Trading uses a limited trading key per device, kept in a separate, isolated frame, which can place orders within the limits the user signs but can never withdraw funds. - **How it earns:** a small builder fee on orders placed through Kokoah, on top of Hyperliquid’s own fees, approved by the user once (see Fees below). - **Network:** Hyperliquid mainnet. - **Main features:** order ticket with take-profit and stop-loss, positions and closing help, spot and convert, charts with drawing tools and 23 indicators, portfolio, history and a trade journal, deposits and withdrawals, alerts (price, moves, steps, funding, PnL, liquidation distance, account margin), guardians (protective rules that act on your positions), bots and algorithmic orders, copy trading, top traders and a twice-daily market pulse, a Telegram bot (alerts, trading with confirmation and PIN, an AI assistant for questions in plain words or voice notes, a morning brief), and 11 languages. - **AI principle:** numbers come from code, never from the AI. The AI drafts and explains; every order is reviewed and confirmed by the user. ## Website - App: https://kokoah.com - Docs: https://kokoah.com/docs - Guides: https://kokoah.com/docs#guides - FAQ: https://kokoah.com/faq - Glossary: https://kokoah.com/help/glossary - Fees: https://kokoah.com/fees - Status: https://kokoah.com/status ## Official accounts - X: https://x.com/kokoahdotcom - Telegram: https://t.me/kokoahdotcom - Discord: https://discord.gg/XXYRc2MMmN - YouTube: https://www.youtube.com/@kokoahdotcom These are Kokoah’s only official accounts. Kokoah never messages anyone first. ## Docs ### Getting started What Kokoah is, signing in and enabling trading. #### What is Kokoah? https://kokoah.com/docs/what-is-kokoah A non-custodial workspace for Hyperliquid perps and spot: how it works, what it costs and where everything is. ##### A trading workspace for Hyperliquid Kokoah is a trading workspace for Hyperliquid: perpetual futures, including HIP-3 markets, and spot tokens in Pro. It brings the order ticket, pre-trade risk checks, positions and balances, alerts, fees and a trade journal into one place. Prices, order books and charts come straight from Hyperliquid. **Kokoah is non-custodial.** Your funds stay in your own Hyperliquid account, controlled by your own wallet. Kokoah never holds them. You trade with a separate [trading key](https://kokoah.com/docs/enable-trading#trading-key) kept on your device. It can place and cancel orders, but it can never withdraw or transfer funds: moving money always needs a signature from your main wallet. ##### How Kokoah is paid Each fill pays Hyperliquid’s exchange fee, as it would anywhere, plus Kokoah’s builder fee on top. The order ticket shows both before you trade. Your main wallet approves the builder fee once, up to a ceiling of 0.1%. The rate you actually pay comes from Kokoah’s public configuration and is shown on the [Fees page](https://kokoah.com/fees). See [Fees](https://kokoah.com/docs/fees) for every cost. ##### The workspace The workspace has four places in the top bar, and two more in Pro: - **Trade**: Markets, the chart, the order ticket and your open positions. Search any market from the top bar. - **Portfolio**: Overview, Positions, Performance, History and Funds, where you deposit, withdraw and send. - **Alerts**: Your alerts, the inbox, the traders you follow and your guardians. - **Account**: Opens Settings over the page you are on: your preferences, security, invites and help. The account menu has Settings too. - **Discover (Pro)**: Top traders, the market pulse report, funding across exchanges and Hyperliquid news. - **Bots (Pro)**: Grid, DCA, copy trading and TradingView signals. On a phone, the places sit in the tab bar at the bottom, and Bots is in the account menu. ##### Simple and Pro Kokoah has two layouts. **Simple** shows the chart, the order ticket and your positions. **Pro** adds the order book, recent trades, a ticker strip and account stats to the Trade page, spot markets, and the Discover and Bots places. Switch with **Layout** in the market header on the Trade page, or in [Settings](https://kokoah.com/docs/settings#layout). Your choice is saved with your settings. Spot trading is in Pro. If you open a spot market in Simple, Kokoah offers to switch to Pro or to choose another market. ##### What needs an account and Kokoah’s services Without signing in, you can browse every market with live prices, the chart and the order book, open Discover, and use the fee calculator and these docs. Signing in adds trading, your portfolio and history, alerts, guardians, bots, Telegram and invites. To trade you also need a funded Hyperliquid account and a trading key on your device: see [Enable trading](https://kokoah.com/docs/enable-trading). Sign-in, history, alerts and notifications, guardians, bots, Telegram and the AI assistant run on Kokoah’s services. Orders go from your trading key straight to Hyperliquid, so a device that is already signed in can keep trading while those services are unreachable; history, alerts and automation wait until they respond. The [status page](https://kokoah.com/status) shows how each part is doing. ##### First steps 1. [Sign in](https://kokoah.com/docs/sign-in) with your wallet, or create an email wallet with email, Google or a passkey. 2. [Deposit USDC](https://kokoah.com/docs/deposits) into your Hyperliquid account. 3. [Enable trading](https://kokoah.com/docs/enable-trading) on this device: up to 2 wallet signatures, once. 4. Place your first order in the [order ticket](https://kokoah.com/docs/order-ticket) and protect it with a [stop loss](https://kokoah.com/docs/tp-sl). 5. Set a [price alert](https://kokoah.com/docs/price-alerts) so you don’t have to watch the chart. #### Sign in https://kokoah.com/docs/sign-in Wallets, the email wallet, the sign-in signature, terms, eligibility, sessions and signing out. ##### Ways to sign in Choose **Sign in** in the top bar. Tick the box that accepts the Terms and the Risk disclosure, then choose how to connect: - **A browser wallet**: Choose Connect a wallet. Wallets installed in your browser, such as Rabby or MetaMask, appear by name. On a phone without WalletConnect, open Kokoah in your wallet app’s browser. - **WalletConnect**: Where it’s available, Connect a wallet opens Choose a wallet: a list of wallets, including a QR code you scan with a wallet app on your phone. - **Email, Google or passkey**: Where it’s offered, this creates an email wallet: a wallet of your own, made for you when you sign up, so you don’t need a wallet app. See [Email wallet](https://kokoah.com/docs/email-wallet). > Use a regular wallet. A smart-contract wallet (such as a Safe) can sign in and use history, alerts and settings, but Hyperliquid accepts only signatures from a regular wallet key, so it can’t enable trading or receive deposits. ##### The sign-in signature Once your wallet connects, it asks you to sign one readable message that starts with “Sign in to Kokoah”. The same message says that you accept the current Terms and Risk Disclosure, and that you’re not a restricted person or using a VPN or proxy to get around restrictions. Signing it only proves that you control the address. It isn’t a transaction: it costs no gas, moves no funds and approves no trades. Each message can be used once and expires within 10 minutes. > Kokoah never asks for your seed phrase or private key. If a page does, it isn’t Kokoah: check the address bar against the [official links](https://kokoah.com/help/official-links). ##### Accepting the terms The terms box on the sign-in card must be ticked before you can connect. Your acceptance travels in the sign-in message, so there is no separate terms step. When the Terms or the Risk disclosure change, Kokoah asks you once to **Accept the new terms**. That takes a tick and **Accept and continue**, with no signature. Until then, you can’t enable trading. Translations of the terms are a courtesy: the English versions are binding. ##### The eligibility check Kokoah checks your region when the app loads and screens your wallet address when you sign in. You only notice it if it blocks you. If trading isn’t available for your account or region, you see **Trading isn’t available in your region**. You can still sign in to close positions, withdraw your funds and revoke Kokoah’s access. The check runs again every 30 minutes and when you come back to the window. See [Eligibility](https://kokoah.com/docs/eligibility) and [regional availability](https://kokoah.com/legal/regions). ##### Staying signed in A sign-in lasts up to 30 days in this browser, and ends sooner after 7 days without use. Reloading the page doesn’t sign you out: your wallet reconnects without a new signature. All tabs of a browser share one account. If your wallet switches to another address, Kokoah keeps you signed in and asks you to switch back in your wallet or to **Sign in as** the new address, which takes one signature. Nothing is signed for the other address meanwhile. Every browser signed in to your account is listed in **Settings** (account menu) → Security → Sessions. ##### Signing out Open the account menu (your address in the top bar) and choose **Sign out**. This ends the session in this browser, stops push notifications to it and locks the trading key on this device. With an email wallet, its login ends too. On a shared or borrowed computer, first tick **Also remove the trading key and this account’s data from this device**. That deletes the key and this account’s data kept in this browser, such as the address book and tracked transfers, so you enable trading again next time. **Sign out everywhere** (Settings → Security → Sessions) signs out every browser. It also unlinks Telegram and turns trading from it off, and pauses signal bots and turns off their webhook links (a new link needs a recent sign-in). Copy, grid and DCA bots, guardians and the automation key keep running. Trading keys stay usable on their devices until they expire or are revoked, so for a lost or stolen device, revoke them as described in [Trading keys](https://kokoah.com/docs/trading-keys). #### Enable trading https://kokoah.com/docs/enable-trading The trading key for your device, the builder-fee approval, what you sign, renewal and what to do if it fails. ##### What enabling does Before your first order on a device, Hyperliquid needs two things: a trading key for this device, approved by your main wallet, and your approval of Kokoah’s builder fee. One button in the order ticket does both. 1. Deposit first. Hyperliquid approves a trading key only for an account that holds funds, so an empty account sees **Deposit to start** instead. 2. In the order ticket, choose **Enable trading**. 3. Approve the trading key in your wallet (signature 1 of 2). 4. Approve the Kokoah fee in your wallet (signature 2 of 2). Kokoah skips this when your account has already approved it. 5. The ticket says “Trading is on.” and you can place your order. You do this once per device. On another device you usually sign only once, because the fee approval is already on your account. ##### The trading key The trading key is a Hyperliquid API wallet (an “agent”) that Kokoah creates for this device. It lives in the signer frame: a small page on its own web address that the app talks to but can’t read. The app never sees the private key. Each device gets its own key with its own name, such as `kokoah-a1b2`, so enabling trading on a new device doesn’t replace another device’s key. Your wallet shows the key’s address, its name and its expiry before you approve. - It can place, change and cancel orders and change leverage. - It can’t withdraw, send or transfer funds, and it can’t approve anything in your main wallet’s name. One exception: it can deposit into HLP, Hyperliquid’s own vault, after you confirm in the signer (at most 10,000 USDC at once and 25,000 in 24 hours), and withdraw from vaults you hold back into your account. - It is stored encrypted on this device and survives reloads. You can require a passkey to use it: see [Trading keys](https://kokoah.com/docs/trading-keys). > Hyperliquid allows 3 trading keys per account. When all 3 are in use, Kokoah lists them and suggests replacing the oldest; the device that used the replaced key stops trading. Kokoah never offers to replace its automation key. A phone linked with **Link phone** gets its own key, approved by the main wallet on your computer. See [Linked devices](https://kokoah.com/docs/linked-devices). ##### The builder-fee approval Kokoah is paid through Hyperliquid’s builder fees: a small fee on each fill, added to Hyperliquid’s own fee. Hyperliquid charges it only after your main wallet has approved Kokoah as a builder, up to a maximum rate. The approval allows at most 0.1% of each fill. That is a ceiling, not the rate you pay: the current rate comes from Kokoah’s public configuration, is shown on the [Fees page](https://kokoah.com/fees) and in the order ticket, and can be lower. See [Fees](https://kokoah.com/docs/fees). You approve it once per account. If you revoke it in Settings → Security → Permissions, the ticket asks for the approval again before your next order. When Kokoah has a Hyperliquid referral code and your account has none yet, the new trading key adds it at the end: 4% off Hyperliquid fees. It needs no wallet signature and never blocks trading. ##### What you sign, and with what - **Your main wallet**: Signs the sign-in message, the trading-key approval, the builder-fee approval, withdrawals, sends, transfers between your balances, account mode changes and revocations. Each is a readable request you can check in your wallet before you sign. - **The trading key**: Signs orders, cancels and leverage changes inside the signer frame, after checking each one against its own safety rules and your [limits](https://kokoah.com/docs/limits). There is no wallet pop-up for these. - **Never**: Your seed phrase or private key, and unreadable order data in your main wallet. Kokoah never asks for them. > Guardians and bots don’t use this key. They use a separate [automation key](https://kokoah.com/docs/automation-key) on Kokoah’s servers, within limits you sign. ##### Expiry and renewal A trading key is valid for 30 days. From 7 days before it expires, Kokoah tells you when it expires and the ticket offers **Renew trading key**. Renewing takes one wallet signature. Kokoah makes a fresh key under this device’s name, which replaces the old one, valid for another 30 days. An expired key can’t sign anything, so you can’t send orders from this device until you renew. On a linked phone, renew from your computer. ##### If enabling fails - **Deposit to start**: Your account is empty. [Deposit](https://kokoah.com/docs/deposits) first; Hyperliquid turns on trading once your account holds funds. - **All 3 trading keys are in use**: Pick a key to replace, or accept the suggested oldest one. The device that used it stops trading. - **You closed or rejected the wallet request**: Nothing changed. Choose Enable trading again when you’re ready. - **No clear answer from Hyperliquid**: Kokoah shows “Checking with Hyperliquid…” and reads your account before it calls the step failed. If it still fails, try again. - **Can’t reach the trading signer**: Reload the page. - **Terms, region or wallet type**: Accept changed terms first, check [eligibility](https://kokoah.com/docs/eligibility), and sign in with a regular wallet rather than a smart-contract wallet. - **A private window**: When the browser can’t store the key, Kokoah says so, and trading turns off when you close the tab. Still stuck? Check the [status page](https://kokoah.com/status) or [contact support](https://kokoah.com/support). ### Trading The order ticket, protection, margin, positions, spot, the chart and the order book. #### The order ticket https://kokoah.com/docs/order-ticket Market, limit and trigger orders, size, leverage, margin mode, slippage, the review and what happens after you send. ##### Where the ticket is The ticket sits next to the chart on the **Trade** page. On phones and tablets, tap **Long** or **Short** at the bottom of the screen to open it as a sheet; what you typed is still there when you open it again. At the top you see the leverage and margin mode (for example **10× Cross**), the largest order on this side as margin (**Max order**; on the side that closes an open position it also counts the part that only closes it, so it can be more than your equity) and your **Equity**. When a [sub-account](https://kokoah.com/docs/sub-accounts) is selected, a line says which account the order goes to. Until your account can trade, the order button shows the next step instead: [sign in](https://kokoah.com/docs/sign-in), a [deposit](https://kokoah.com/docs/deposits) card while the account is empty, or [Enable trading](https://kokoah.com/docs/enable-trading). Smart-contract wallets can’t sign orders here; connect a regular wallet. In the **Simple** layout the ticket offers **Market** and **Limit**, with stop and take-profit orders under **Advanced → Trigger**. **Pro** adds a **More** menu with the same trigger orders and the [algo orders](https://kokoah.com/docs/algo-orders), and keeps **Advanced** open on this device once you open it. Switch with **Layout** in the market header or in **Settings** (account menu) → Trading. ##### Order types Pick **Long** or **Short**, then the order type: - **Market**: Fills now against the order book, within your slippage limit. It’s sent as an immediate-or-cancel order with a limit at the mid price plus or minus your max slippage, so it can’t fill beyond that price. - **Limit**: Rests on the book and fills only at your price or better. The Mid, Bid and Ask chips fill in the price for you. - **Stop market and Stop limit**: When the mark price reaches your trigger, a market order is sent (stop market) or a limit order is placed at your price (stop limit). - **Take profit market and Take profit limit**: The same for taking profit: they fire when the mark price reaches your target. A trigger that is already past the mark would fire at once, so the ticket refuses it and says which side of the mark it must be on. Market trigger orders fill with up to 10% slippage when they fire. Picking a price in the order book or on the chart while Market is selected switches the ticket to a limit order at that price. Under **Advanced** you also find: - **GTC**: Good till canceled, the default for limit orders: the order rests until it fills or you cancel it. - **Post only**: The limit order only adds liquidity: Hyperliquid refuses it instead of letting it fill at once, and its fills pay the maker fee. - **IOC**: Immediate or cancel: fills what it can right away and cancels the rest. - **Reduce only**: The order can only shrink or close your position, never open or grow one. Reduce-only orders can’t carry a take profit or stop loss. ##### Size Enter the size in USD or in the coin. Switch with **Advanced → Size in**, and set the default in **Settings** (account menu) → Trading. The line under the field shows the other unit, for example “= 0.52 ETH at $3,000”. USD is converted at the price the order executes at: the mark price for a market order, your limit price for limit orders, and the trigger price for stop market and take profit market orders. The size is rounded down to the market’s size decimals. **25%**, **50%**, **75%** and **Max** fill in a share of the largest size Hyperliquid allows on this side at your current leverage, not a share of your balance. > Hyperliquid’s minimum order value is $10, checked at the order’s own price (for a market order, its worst-case price). Only a reduce-only order that closes a whole position may be smaller. When a size is too small or too large, the ticket offers a fix such as **Set $10** or **Use max**; on a standard account with spare USDC in spot, it can offer to [move it to perps](https://kokoah.com/docs/move-funds) with one wallet signature. ##### Leverage and margin mode Press the leverage chip at the top of the ticket to open **Leverage and margin**. Choose a whole number from 1× up to the market’s maximum, and **Isolated** or **Cross**, then confirm. Hyperliquid keeps this setting per market for your account. The change is its own exchange action, signed by your trading key. If you have an open position in the market, its margin and liquidation price change at once. Hyperliquid may refuse to switch the margin mode while a position is open. Some markets are isolated only; the ticket says so and Cross can’t be picked. Larger positions fall into margin tiers with a lower maximum leverage, and the ticket blocks an order whose leverage is above the maximum for its size. Your own [limits](https://kokoah.com/docs/limits) can cap leverage too. Until your leverage for the market has loaded from Hyperliquid, the ticket waits; it never assumes 1×. How leverage moves your liquidation price is explained in [Margin and liquidation](https://kokoah.com/docs/margin-and-liquidation). ##### Slippage and price limits Set **Advanced → Max slippage** with the 0.5%, 1% or 3% chips, or type your own from 0.01% to 5%. The starting value comes from **Settings** (account menu) → Trading → Slippage, which is 1% unless you change it. A market order’s worst-case price shows under the setting and in **Details**. For a market order, Kokoah’s signer reads the mid price from Hyperliquid itself and signs a limit at the mid plus (buy) or minus (sell) your slippage, on a valid price step. Whatever the book can’t fill within that price is canceled. The order’s result names the limit that was signed. The signer also checks how far prices are from the mark: orders that execute now must be within 5% of it (your limits can make this tighter), resting limit orders and untriggered stops within 50%, and a trigger order’s limit price within 10% of its trigger. The ticket warns while you type, so a typo such as 8,500 for 85,000 is caught. Prices must fit the market’s price step: whole numbers always do; other prices can have at most 5 significant figures and 6 decimals minus the market’s size decimals. When a price doesn’t fit, the ticket shows the nearest valid price; it never rounds your price silently. ##### Review and confirm Under the fields the ticket shows **Margin**, **Liq. price** and **Fees** for the order, plus the most important warning. **Details** opens the full picture: notional, estimated entry, worst-case price, loss at the stop, [Hyperliquid and Kokoah fees](https://kokoah.com/docs/fees) for entry and exit, funding per hour and per day, liquidation distance, and your account leverage after the order. Press **Buy / Long** or **Sell / Short** to open the review, for example “Buy 0.52 ETH at market?”. It repeats the value, leverage, margin, liquidation price, fees and your TP/SL, lists the warnings and the [pre-trade checks](https://kokoah.com/docs/pre-trade-checks), and sends the order only when you confirm. Choose when the review appears in **Settings** (account menu) → Trading → **Confirm orders**: **Always** (the default), **Only above an amount**, or **Only when there’s a warning**. “Don’t ask again” in the review picks the last one. Orders with a warning, orders drafted by the [AI assistant](https://kokoah.com/docs/ai-assistant) and orders whose value isn’t known yet are always reviewed. While something is missing, the button stays inactive and a line under it says why, for example “Enter a size.”, “Waiting for fresh market data.” or “Enable trading first.”. During exchange maintenance or post-only mode, only post-only limit orders are accepted. ##### After you send Your trading key signs the order inside Kokoah’s signer, so there’s no wallet pop-up for each order. A key protected by a passkey asks for the passkey first; if you cancel that prompt, nothing is sent. See [trading keys](https://kokoah.com/docs/trading-keys). Every order carries a client order ID ([cloid](https://kokoah.com/help/glossary#cloid)), so Kokoah can look it up on Hyperliquid even if the answer gets lost. A message confirms the fill or the placement, and **Last order** in the ticket shows each part (the order, its take profit and its stop loss) as Placed, Partially filled, Filled, Waiting, Active or Rejected. If the signer can’t confirm the result, the ticket shows “Checking…” while Kokoah looks the order up by its ID. Don’t send it again. A signed order is only valid for 15 seconds; if Hyperliquid still has no record of it shortly after that, it’s marked “Not placed” and it’s safe to try again. While an earlier action is being checked, new orders that add risk wait; reduce-only orders and cancels still go through. The **Positions** panel shows the check with **Check now**, and **Dismiss…** for when you’ve checked your orders yourself. The same order is never sent twice, even from two tabs. #### Take profit and stop loss https://kokoah.com/docs/tp-sl Protect a new order or an open position: how triggers fire, the safety rules, and how to change or cancel them. ##### On a new order Turn on **Add TP/SL** in the ticket and fill in **Take profit**, **Stop loss** or both. They’re sent together with the order as reduce-only orders on the opposite side, sized to this order. They activate only once the entry has fully filled; until then the ticket shows them as Waiting. A limit order that fills only partly can leave that part unprotected, so to protect a whole position use [TP/SL on the position](https://kokoah.com/docs/tp-sl#on-position). Each field shows an estimate: the profit at the take profit before fees, and the loss at the stop with and without fees. The review repeats both, or reminds you that without a stop the loss can reach your margin (with cross margin, your equity). Add TP/SL isn’t offered on reduce-only orders or on stop and take-profit orders. ##### Price, %, USD or ROE Use **Enter TP/SL as** to choose how you type them: - **Price**: The trigger price itself. - **%**: The price move from your entry, for example 5 for a 5% move. - **USD**: The profit or loss in dollars when it triggers, before fees. - **ROE**: The return on your margin in percent, before fees. At 10× leverage, a 1% price move is 10% ROE. For anything other than Price, the field shows the trigger price it works out to (“Triggers at …”). The entry used is the mark price for a market order and your limit price for a limit order. Switching between Price and % keeps your values; USD and ROE start empty. ##### How they trigger and fill Take profits and stops trigger on the [mark price](https://kokoah.com/help/glossary#mark-price), not on the last trade. By default they exit at market: when the trigger is reached, a market order goes out with up to 10% slippage. A stop is not a guaranteed price; in a fast market the fill can be worse than the trigger. The loss the review shows for a market stop allows for 0.5% slippage plus fees. To exit with limit orders instead, set **Advanced → TP/SL exit orders** to **Limit** and enter **Take profit limit** and **Stop loss limit**. Each limit must be within 10% of its trigger, and a stop-loss limit must be on the side that fills (for a long, at or below its trigger), or it could rest unfilled after the stop fires. A limit exit may not fill at all if the price moves past it. On a few markets one price step is too large for a market trigger, and the signer refuses a stop market there. Use a stop limit or a limit exit instead. ##### Safety rules The ticket checks your take profit and stop before the review, so a stop can’t fire on your own entry: - **Stop buffer.** A stop must sit a little beyond the entry: 0.1% on Hyperliquid’s deepest markets (40× leverage and up, such as BTC), 0.2% from 20× (such as ETH and SOL), 0.3% from 10× and 0.5% on the rest. The distance is measured from the worse of the estimated entry and the mark price. Hyperliquid sets no minimum; Kokoah keeps this one so ordinary price noise can’t fire a stop right away. - **Gentle fix.** A stop on the right side but inside the buffer is moved to the nearest safe price when you leave the field, with a note such as “Moved to $2,985 so it can’t fire on your own fill.” - **Wrong side.** A stop above the entry of a long (below it for a short), or a take profit on the losing side, is never sent. The ticket explains why and offers a **Use** button with a valid price. - **Beyond liquidation.** A stop past the estimated liquidation price would never trigger before liquidation. The ticket warns and the order always goes to the review. - **Large loss.** The ticket warns when the loss at the stop would be more than 10% of your equity. If the entry still fills past your stop, the stop fires right away. The ticket then says “Your stop loss fired right away”, and the position gets a banner with a fix (see [Change or cancel](https://kokoah.com/docs/tp-sl#edit-cancel)). The guide [Stops, margin, and liquidation](https://kokoah.com/learn/stops-and-liquidation) explains the ideas behind these rules. ##### On an open position In **Positions**, press **TP/SL** on the row. Enter a price or a **% from entry**; the fields start with the current values. These exits are market orders for the whole position. Because the position is already open, the stop buffer is measured from the current mark price. A stop inside it is moved when you leave the field (“Moved to … so a small move can’t fire it right away.”), and one on the wrong side is never sent. **Save TP/SL** sends only what changed. A new take profit or stop is placed first and the old one is canceled after it, so a failure never leaves the position without its old stop. To remove one, clear its field and save. The **TP / SL** column shows what protects each position: the prices, **No stop loss**, or **SL triggered, not filled**. For a stop that follows the price, use a [trailing stop](https://kokoah.com/docs/algo-orders#trailing-stop) (Pro) or **Protect…** in the row menu, which sets up a [guardian](https://kokoah.com/docs/guardians). ##### Change or cancel Every take profit, stop and trigger order is listed in **Positions → Open orders** with its condition, for example “Trigger: mark ≥ $3,200”. Position TP/SL orders are marked **Position TP/SL**, with the size **Whole position**. **Modify** changes the trigger price, the limit price or the size, and shows a review before it replaces the order in place. **Cancel** removes an order in one click, without a review. The row menu can cancel all orders in that market. A stop that fired but didn’t fill rests as a limit order, shown as “Triggered · waiting to fill at …”, with a warning when it sits where it gives no protection. The position then gets a banner: **Replace the stop** asks you to confirm canceling the stale order, then opens the TP/SL editor with a new stop suggested 0.5% beyond the mark. Check it before you save. #### Margin and liquidation https://kokoah.com/docs/margin-and-liquidation How margin and leverage work, cross versus isolated, the liquidation price, adding margin, and funding. ##### Margin Opening a position locks margin: the position’s value divided by your leverage. A $1,000 position at 10× uses $100. The ticket’s Margin figure is what this order adds; an order that reduces a position adds none. To stay open, a position needs its maintenance margin: half the margin required at the market’s maximum leverage. On a market with a 50× maximum, that’s 1% of the position’s value. Large positions fall into higher margin tiers, with a lower maximum leverage and more maintenance margin. Open **Market info** in the market header to see a market’s maximum leverage, its margin modes and its margin tiers. If an order needs more margin than you have available, the ticket blocks it and says how much it needs. ##### Leverage and liquidation distance Leverage decides how far the price can move against you before your margin is gone. At 10×, a 10% move against you costs the whole initial margin; at 50×, a 2% move does. The ticket warns from 10× up. Change leverage with the chip in the [order ticket](https://kokoah.com/docs/order-ticket#leverage), or with **Leverage…** in a position’s row menu. It’s a whole number from 1× to the market’s maximum. On an open position it applies at once and moves the liquidation price. Your overall leverage, the value of all positions divided by your equity, shows as **Account leverage** in the account row of the Pro layout, and as “Account leverage after” in the ticket’s **Details**. ##### Cross and isolated margin - **Cross**: Your cross balance backs all your cross positions together. Profit in one helps the others, but a loss in one brings the others’ liquidation closer, and without a stop the loss can reach your account equity. - **Isolated**: The position has its own margin. The most it can lose is that margin, and your other positions aren’t affected, but it can’t draw on the rest of your balance. Some markets are isolated only, such as pre-launch perps, and on some of them margin can’t be removed while the position is open. **Market info** shows which. See also [cross and isolated margin](https://kokoah.com/help/glossary#cross-isolated) in the glossary. In Pro, **Account leverage** also shows the health of your cross margin: **Healthy** below 50%, **Caution** below 80%, and **At risk** above that. The percentage is your cross maintenance margin divided by your cross account value; cross positions are liquidated at 100%. ##### The liquidation price The ticket estimates the liquidation price of the position after your order with Hyperliquid’s published formula and the market’s margin tiers. For cross margin it uses your account value after the order and keeps your other positions’ maintenance margin as it is; for isolated margin it uses the position’s own margin. It’s an estimate: other cross positions, funding and fees move the real liquidation price over time. The **Liq. price** column in Positions shows Hyperliquid’s own figure and how far it is from the mark; **None** means the position can’t be liquidated. The ticket warns when liquidation would be within 5% of the mark price, and when a stop loss sits beyond it. To hear about it before it gets close, set a [distance to liquidation alert](https://kokoah.com/docs/account-alerts). > If the mark price reaches the liquidation price, Hyperliquid liquidates the position and you lose margin. In rare cases the exchange also closes profitable positions on the other side ([auto-deleveraging](https://kokoah.com/help/glossary#adl)). The guide [Stops, margin, and liquidation](https://kokoah.com/learn/stops-and-liquidation) walks through an example. ##### Add or remove isolated margin For an isolated position, open the row menu in **Positions** and choose **Margin…**. Pick **Add** or **Remove** and enter an amount in USD; the dialog shows the estimated liquidation price after the change. Adding margin moves liquidation further away; removing it brings liquidation closer. **Add margin** or **Remove margin** sends the change right away, signed by your trading key. Hyperliquid keeps no record that confirms a margin change later, so if the answer gets lost, check the position before you try again. Markets whose margin can’t be removed refuse a removal while the position is open. Cross positions share your balance and have no Margin… option; to give them more room, [move funds](https://kokoah.com/docs/move-funds) into your perps balance or lower the position size. ##### Funding Perpetuals have no expiry; [funding](https://kokoah.com/help/glossary#funding) keeps their price close to the underlying. It’s paid every hour between longs and shorts, based on the oracle price. When the rate is positive, longs pay shorts; when it’s negative, shorts pay longs. The ticket’s **Details** show what the position would pay or receive per hour and per day at the current rate. The ticket warns when your side would pay 0.01% an hour or more (about 88% a year). In Positions, the **Funding** column shows what a position has received (+) or paid (−) in funding since it opened. Funding you pay comes out of your margin, so over time it moves the liquidation price. Compare rates across markets on the [funding board](https://kokoah.com/docs/funding-board). #### Positions https://kokoah.com/docs/positions Read your open positions, close them in full or in part, handle a thin order book, reverse, and manage open orders. ##### The positions panel You find it below the chart on the **Trade** page and under **Open positions** in Portfolio. Its tabs are **Positions**, **Open orders** and **Recent fills**; Pro adds **Algos** and **Balances**. Each position shows: - **Market**: The ticker, Long or Short, the leverage and margin mode, and a Delisted badge when that applies. - **Size**: The size in the coin, with its value in USD under it. - **Entry and Mark**: Your average entry price and the current mark price. - **Liq. price**: Hyperliquid’s liquidation price and how far it is from the mark. - **PnL**: Unrealized profit or loss at the mark price, before closing fees, with the ROE (the return on the position’s margin) under it. - **Margin**: The margin in use, with the funding paid or received since the position opened. - **TP / SL**: The take profit and stop loss that protect the position, or No stop loss. Click Market, Size, PnL or Margin to sort. Amounts are hidden while Hide balances (the eye in the top bar) is on. ##### Close a position **Close** on the row sends a reduce-only market order for the whole position, with the slippage from **Settings** (account menu) → Trading. A small box next to the button asks once (**Close position** or **Cancel**) and shows the size and your PnL now. The result appears above the table, for example “Closed at $3,012 · PnL +$12.40”, with a **Share** button. **Close all** in the panel header closes every position at market after one review. Each close is sent on its own, and the review lists what went through. During exchange maintenance or post-only mode, or while live prices are missing, market closes are paused and **Close** becomes **Limit close…**. Delisted markets can’t be closed here; they settle on Hyperliquid at the final price. If trading isn’t available in your region, you can still close positions and cancel orders (see [eligibility](https://kokoah.com/docs/eligibility)). ##### Close part, or at a limit price In the row menu, **Close part…** closes a percentage at market: pick 25%, 50%, 75% or 100%, or use the slider. **Limit close…** places a reduce-only limit order for the percentage you choose, at your price; it rests until it fills or you cancel it. Hyperliquid needs at least $10 for a partial close, so the dialog tells you the smallest percentage that works; only closing the whole position may be smaller. A limit price far from the market gets the same price-band warning as in the ticket. Both are sent when you press the dialog’s button, for example “Close 50% at market”, without a second review. ##### When the book is too thin to close A market close only fills within your slippage. If there are no buyers (for a long) or sellers (for a short) within it, Hyperliquid rejects the close and nothing changes. Kokoah then reads the order book and shows “Not closed” with what it would take: - **Close with up to …% slippage** closes everything with a wider slippage, offered when the whole position fits within 5%. The slippage is what the book needs plus 0.1% for the book moving, rounded up to 0.1%, and the message shows the average price you would get. - **Limit close at** the best price fills what it can now and leaves the rest on the book until it fills. If even 5% isn’t enough to close everything, only the limit close is offered. Nothing is sent until you press one of the buttons. ##### Add to or reverse a position **Add to position** opens the ticket on the same side with a note about your current position. Enter the size to add; the review shows the new average entry and liquidation price. **Reverse position…** (Pro) closes the position at market, then opens the same size the other way at the same leverage. Both orders are in one review with their fees, about two taker fees in total. The second is only sent if the close went through. > If the second order of a reversal can’t fill, you’re left with no position. ##### Other row actions Next to **Close**, each row has a **TP/SL** button and a menu with more actions: - **TP/SL**: Sets the take profit and stop loss for the whole position. See [TP/SL on a position](https://kokoah.com/docs/tp-sl#on-position). - **Leverage…**: Changes the leverage or margin mode for the market; it applies to the position at once. See [leverage](https://kokoah.com/docs/margin-and-liquidation#leverage). - **Margin…**: Adds or removes margin on an isolated position. See [isolated margin](https://kokoah.com/docs/margin-and-liquidation#isolated-margin). - **Protect…**: Sets up a [guardian](https://kokoah.com/docs/guardians) that runs on Kokoah’s servers: Trail, Close at a loss, or Take half. - **Alert…**: Creates a [price alert](https://kokoah.com/docs/price-alerts) for the market. - **Share PnL**: Makes a card of the position’s result to [share](https://kokoah.com/docs/share-pnl). Above the table, actions that are still being checked with Hyperliquid show their status with **Check now**; see [After you send](https://kokoah.com/docs/order-ticket#after-submit). ##### Open orders and fills **Open orders** lists your resting orders with their type, price, size and where they came from: Kokoah, a guardian, an AI draft, a bot, Telegram or another app. A partly filled order shows how much has filled. To move a limit order, click its price, type the new one and press Enter; Escape keeps it. On touch screens and for trigger orders, use **Modify**, which shows a review before it replaces the order. Spot orders can’t be modified: cancel them and place a new one. **Cancel** removes an order in one click; the row menu cancels all orders in that market, and **Cancel all** in the header cancels every order after a review. **Recent fills** lists your latest fills with the price, size, Hyperliquid fee, Kokoah fee and realized PnL. Your full record is in [Portfolio → History](https://kokoah.com/docs/history). #### Pre-trade checks https://kokoah.com/docs/pre-trade-checks The risk warnings in the ticket and the quick checks in the review: what each one looks at, its thresholds, and when it shows. ##### Two layers of checks Kokoah checks an order twice before you send it. The ticket’s own risk warnings are worked out in your browser from the order, your account and the live market. Some of them stop the order; the others make sure you see the review. When the review opens, **Check before I confirm** adds up to three short notes from Kokoah’s servers, such as how your liquidation distance compares with a normal day’s move, or fresh news. They never block an order. Both are fixed rules written in code, with no AI involved: the same order and market data always give the same result. ##### What stops an order The order button stays inactive, with the reason under it, when: - The order needs more margin than you have available. - The leverage is above the maximum for a position of this size (the market’s margin tiers). - Cross margin is chosen on an isolated-only market. - A reduce-only order wouldn’t reduce anything: there’s no position, or it’s on the same side. - The order is worth less than $10, unless it’s a reduce-only order that closes the whole position. - The market is at its open-interest cap and isn’t accepting new positions. - A take profit or stop is on the wrong side, or a price doesn’t fit the market’s price step (see [safety rules](https://kokoah.com/docs/tp-sl#safety-rules)). Kokoah’s signer then applies your own [limits](https://kokoah.com/docs/limits) and its [price bands](https://kokoah.com/docs/order-ticket#slippage), and refuses what they don’t allow even if the ticket let it through. ##### Warnings that always get a review These don’t block the order, but any of them opens the review even if your settings would skip it: - **Liquidation near**: The estimated liquidation price is within 5% of the mark price. - **Stop beyond liquidation**: The stop loss would never trigger before liquidation. - **Large loss at the stop**: The loss at the stop, with slippage and fees, would be more than 10% of your equity. - **High leverage**: 10× or more on an order that opens or adds to a position. - **Thin book**: A market order is more than 25% of the visible depth within 1% of the mid price. - **Book too shallow**: The visible order book isn’t deep enough to fill the whole market order. - **Extreme funding**: Your side would pay 0.01% an hour or more (about 88% a year). - **Price far from mark**: A limit price is more than 5% from the mark price. - **Market closed**: The market behind a HIP-3 perp, such as a stock exchange, is closed, so the price may jump when it reopens. - **Position flip**: The order closes your position and opens one on the other side. - **Price band**: The signer would refuse a price this far from the market. Notes such as “No stop set”, “This order increases your existing position” or a reduce-only order larger than the position appear in Details without forcing a review. The first warning shows under the ticket’s summary, all of them are in **Details**, and the review lists them. **Explain this risk** in Details puts the numbers into plain words; when Kokoah’s AI features are on, the explanation is written by the AI, in your language. ##### Check before I confirm The review asks Kokoah’s servers to look at the order with fresh data from Hyperliquid. They return at most three notes, warnings first, then tips (marked with a light bulb): - **A normal day’s move**: Warning: liquidation after the order would be closer than 1.5 times the coin’s average daily high-to-low range over the last 14 days. - **No stop near liquidation**: Warning: there’s no stop loss and liquidation would be within 15%. - **Overall exposure**: Warning: your positions in the same direction plus this order would be worth more than 3 times your account value. - **Thin book**: Warning: a market order couldn’t fill completely within 1% of the mid price. - **Expected slippage**: Tip: a market order’s average fill would be more than 0.3% from the mid price. - **Funding**: Tip: funding runs against your side at about 20% a year or more. From about 50% a year it’s a warning. - **News**: Tip: an important headline about the coin in the last 2 hours. - **Top traders**: Tip: at least 70% of the [top traders’](https://kokoah.com/docs/top-traders) positions in the coin are on the other side. The liquidation checks look at the position after the order, at your leverage for the market, and only for orders that open a position or add to one. ##### When checks are skipped The review shows no server notes for: - Reduce-only orders, since they can only lower your risk. - Notes the ticket already makes: the funding note is left out when the ticket warns about extreme funding, and the thin-book and slippage notes when it warns about a thin or shallow book. - HIP-3 markets and spot pairs: the checks cover Hyperliquid’s main perp markets. - Times when Kokoah’s servers can’t answer or have nothing to say, and after more than 30 checks in a minute. The checks need Kokoah’s services and a signed-in account. They never delay the order: you can confirm while they load. ##### Turn the checks off Check before I confirm is on by default and runs both in the app’s review and in Telegram trade previews. To turn it off, open **Settings** (account menu) → Trading and switch off **Check before I confirm**. The same switch is under Settings → Telegram once a [Telegram chat is linked](https://kokoah.com/docs/telegram-setup). The ticket’s own risk warnings can’t be turned off. #### Algo orders https://kokoah.com/docs/algo-orders Pro order types that work over time: Scale, Chase, TWAP, Trailing stop and Bracket, where each one runs, and how to follow them. ##### How algos work In the **Pro** layout, open **More** next to Market and Limit in the ticket and pick an algo. Each one shows its plan, asks once in a review, and then places normal Hyperliquid orders for you, each with the Kokoah fee, through the same signer and limits as the ticket. Some algos run in your browser and show **Keep this tab open**; others run on Kokoah’s servers and show **Runs on Kokoah servers**. The first time something needs the servers, you turn on [guardians](https://kokoah.com/docs/guardians) with two wallet signatures. Server-run algos act within the [automation limits](https://kokoah.com/docs/automation-key) you signed and can never withdraw. Chase and TWAP can wait for a **Start at** price: nothing is placed until the mark reaches it. ##### Scale Places 2 to 50 limit orders between a start and an end price, each its own order. Choose how the size is spread: Even, more near the Start or the End (the largest order three times the smallest), or Custom percentages that add up to 100. The preview lists every order and flags any that would fill at once instead of resting. The orders are sent one by one from this tab; if one is refused, the rest aren’t sent. Each counts toward your [limit of orders per minute](https://kokoah.com/docs/limits). Turn on **Reduce only (scale out)** to ladder out of a position. For entries, an optional **Stop loss** becomes one stop for the whole position, resized as the orders fill: while this tab is open, or on Kokoah’s servers with **Keep the stop on Kokoah’s servers**. ##### Chase Places a post-only order one price step inside the best bid (to buy) or ask (to sell) and moves it as the price runs away, until it fills. It re-prices at most every 2 seconds by canceling and placing a new order, and stops after 5 post-only rejections. Up to 5 chases can run at once. Options: **Chase to** a price or a percentage (under 50%), and whether to rest there or cancel when it gets there; a **Time limit** in minutes, after which the rest is sent as immediate-or-cancel; and **Reduce only**. A chase runs in this tab. With guardians available, choose what happens **If this tab closes**: **Leave it** keeps the last order on the book (“Chase stopped”), **Cancel it** has Kokoah cancel the order, and **Keep going** hands the chase to Kokoah’s servers, which re-price at most every 15 seconds. Kokoah steps in after the tab has been quiet for 90 seconds. Keep going is for reduce-only chases, or entries your automation limits allow without a stop. ##### TWAP Splits a size into immediate-or-cancel slices over time, each with its own slippage cap (0.5%, 1% or 3%), so nothing is left resting. A TWAP runs from 5 minutes to 7 days, with at least 30 seconds between slices, and each slice must be worth at least $10. **Random size and timing (±20%)** varies each slice and is on by default. An optional **Price limit** pauses the TWAP while the price is worse than it and resumes when the price comes back. Slices also pause during Hyperliquid’s maintenance and post-only window. A reduce-only TWAP that shrinks or closes your position runs on Kokoah’s servers once guardians are on, even with the app closed. Every other TWAP runs in this tab and pauses if the tab closes, with nothing resting, until you resume it. ##### Trailing stop Protects an open position with a real stop order on Hyperliquid that follows the best price and never loosens. Set the distance in % or USD; the ticket shows where the stop starts. An optional Activation price keeps the stop where it starts until the price reaches it. It runs on Kokoah’s servers, even with the app closed. When the stop moves, the new stop is placed before the old one is canceled. If your current stop is already tighter, the trail takes it over; otherwise a new stop is added and your current one stays. The position’s **TP / SL** column shows the trail, for example “Trail 3%” with its current stop. You can also set one with **Protect…** in the position’s row menu. ##### Bracket An entry (market, limit, or a stop entry that fires on the mark price) with a stop loss and up to three take profits, each closing a share of the size. Exits can be prices or percentages from the entry. A take profit worth less than $10 on its own joins the next one. Options: **Move the stop to breakeven after TP1**, and **One-cancels-other**, a second limit or stop entry with the same size and exits, where the first entry to fill cancels the other. The take profits and the stop are reduce-only orders that rest on Hyperliquid once the entry fills, and Hyperliquid cancels what’s left when the position closes. Kokoah’s servers do what Hyperliquid can’t do by itself: take profits for a resting entry, the move to breakeven and canceling the other entry. Those need guardians. ##### Follow and stop algos **Positions → Algos** (Pro) lists every algo with its progress, for example “TWAP 12/120 · 40% filled” or “Scale 3/5 filled”, where it runs, its orders, and any start price it’s waiting for. **Pause** and **Resume** hold and restart a TWAP or a server-run algo. **Stop**, **Stop trailing** or **Stop managing** ends an algo; for a scale ladder, **Cancel orders** cancels its resting orders. Afterwards, check **Open orders** for anything you want to keep or cancel. **Clear finished** tidies the list. Algos that run in the browser are saved on this device: a reload picks a chase back up, and other tabs show the progress while only one of them runs it. #### Spot and Convert https://kokoah.com/docs/spot-and-convert Buy and sell tokens without leverage in Pro, swap stablecoins, and move USDC between spot and perps. ##### How spot differs from perps On spot you buy the token itself with USDC and sell it back for USDC. There is no leverage, no funding and no liquidation: you own what you buy. Spot trading is part of **Pro**. If you open a spot pair in Simple, Kokoah offers **Switch to Pro**. Spot always uses your main account: if a sub-account is active, switch to the main account in the account menu to trade spot. - Market and limit orders only: Hyperliquid has no stop, take-profit, trailing or reduce-only orders on spot. - Spot orders can’t be edited or dragged on the chart: cancel and place a new one. - Hyperliquid’s minimum order is 10 USDC. - Spot orders are signed by your trading key, like perps orders. See [enabling trading](https://kokoah.com/docs/enable-trading). ##### Finding spot pairs Open the market picker and choose the **Spot** filter, or **Spot markets** under the results. The **Spot** tab of **All markets** lists pairs with their price, 24h change, 24h volume and market cap. By default the list shows only pairs Kokoah can trade that trade actively: verified tokens and stablecoins against USDC with at least $10,000 of 24h volume. Turn on **Show all pairs** to see the rest, each with a badge. - **Unverified**: Anyone can create a token on Hyperliquid, and it can be worthless or copy a well-known name. Kokoah shows these tokens but never trades them. - **Thin**: The pair traded little in the last 24 hours, so prices can jump and orders may not fill. - **A token name**: The pair is priced in that token, not in USDC. Kokoah trades pairs against USDC only. Verified means the token is on Hyperliquid’s own strict list. Kokoah pins each one by its token id, so a renamed or look-alike token is never traded. **Market info** on a spot pair shows the token id, the Kokoah check, the minimum order, the size step and your fees. ##### The spot ticket 1. The first time on a device, choose **Turn on spot trading** and confirm it in the Kokoah signer window. This lets your trading signer place spot orders too. **Turn off spot trading on this device** undoes it. 2. Pick **Buy** or **Sell**, then **Market** or **Limit**. For a limit order, **Mid**, **Bid** and **Ask** fill in the price, and you choose the time in force: **GTC** rests until it fills or you cancel it, **Post only** only adds liquidity and is cancelled if it would fill at once, **IOC** fills what it can now and cancels the rest. 3. Enter the size in USDC or in the token (**Size in**). The 25%, 50% and **Max** chips use a share of your available balance: spot USDC for a buy, the token for a sell. 4. Check **Order value**, **Fees** and **You receive**, then press **Buy** or **Sell**. Depending on your order confirmation setting, a review with the price, the worst price and the fees comes first. A market order is sent as an immediate order with a worst price: your slippage setting away from the mid price (1% unless you changed it). If the book is thin, only part may fill within that price and the rest is cancelled; the ticket warns you before you send it. > On mainnet, Kokoah’s signer also limits one order on a verified token to 10% of what the pair traded in the last 24 hours, and refuses pairs that didn’t trade at all. **Market info** and the ticket’s **Details** show the current **Kokoah maximum per order**. ##### Spot fees Hyperliquid charges its spot fee on buys and sells, at your taker or maker rate. A buy pays it in the token you receive; a sell pays it in USDC. Pairs of two stablecoins pay 80% lower Hyperliquid fees. Kokoah’s fee applies to spot **sells only**; buys carry none, because Hyperliquid applies builder fees to spot sells only. The ticket’s **Details** and **Market info → Your fees here** show your rates. See [fees](https://kokoah.com/docs/fees). ##### Spot balances In Pro, the **Balances** tab under the chart lists every token you hold on spot: the balance (and how much is free when open orders hold some), its value at the USDC price, and the average cost and PnL when Hyperliquid records what you paid. **Trade** opens the token’s USDC pair. Portfolio’s overview adds a **Spot balances** card once you hold a token besides USDC. Tokens Kokoah doesn’t trade show **Not traded here** or **No USDC pair** instead of **Trade**. ##### Convert stablecoins **Portfolio → More → Convert stablecoins** swaps USDC and the other stablecoins Hyperliquid lists. It is one immediate spot order on the stablecoin/USDC pair, signed by your trading key. It shows once your account has funds, and offers only the pairs pinned in Kokoah that Hyperliquid confirms. How the quote is worked out: Kokoah reads the pair’s order book every 3 seconds. The worst price is the mid price plus 0.5% for a buy, or minus 0.5% for a sell. The quote walks the book up to that price to estimate the average price and how much fills. **You receive about** is that fill minus Hyperliquid’s taker fee (the stablecoin-pair rate, 80% lower) and, when you sell a stablecoin for USDC, Kokoah’s fee. For a buy, the size is set so that even at the worst price it stays within your USDC. - Anything that can’t fill within 0.5% of the mid is cancelled, never left resting. A warning shows when the book is too thin for the whole amount. - Hyperliquid’s minimum order is 10 USDC. - The summary shows **You receive about**, **Price**, **Hyperliquid fee**, **Kokoah fee** (**None on buys**) and **Worst price**. In a Standard account with too little USDC on spot, Convert first moves the missing USDC from perps to spot (a wallet signature), then converts (your trading key). On a linked device, move the USDC on your computer first. When you convert to USDC in a Standard account, the USDC lands in your spot balance. > If Hyperliquid’s answer is unclear, Kokoah says it is checking the conversion. It was not sent twice: check your balances before you convert again. ##### Moving USDC between spot and perps A **Standard** account keeps separate spot and perps balances. Open **Portfolio → More → Move spot ↔ perps**, enter an amount, then choose **Spot → perps** or **Perps → spot**. It takes one wallet signature. When a spot buy needs more USDC than your spot balance holds, the spot ticket also offers **Move … USDC to spot**. A **Unified** account uses one balance for both, so there is nothing to move. See [moving funds](https://kokoah.com/docs/move-funds). #### The chart https://kokoah.com/docs/chart Intervals, candles or line, 23 indicators, drawing tools, and your orders and position on the price. ##### Intervals and chart types The chart is the same in Simple and Pro. Choose an interval: **1m**, **5m**, **15m**, **1h**, **4h**, **1d** or **1w** (1h when the page opens). Switch between **Candles** and **Line**; the chart type is kept in this browser. On a narrow panel the intervals fold into a list and the other controls into **Chart options**. The line above the chart reads the candle under the pointer, or the latest one: its time, **O** open, **H** high, **L** low, **C** close, the candle’s change, **V** volume in the coin, and the value of each indicator you have on. Scroll left for older candles. They come from Kokoah’s servers, shared by everyone, so scrolling back doesn’t use your own Hyperliquid request limit. Hyperliquid keeps the latest 5,000 candles of each interval; for older history Kokoah loads its own stored candles where it has them. A note tells you when you reach the start. ##### Indicators Press **Indicators** to open the picker. There are 23 indicators in five groups. Search by name, then tick as many as you like: a choice applies at once, and **Remove all** clears them. Each indicator’s settings are fixed and shown in its name (RSI 14, for example). Your choice is kept in this browser. - **Moving averages**: MA 20, MA 50, MA 200, EMA 20, EMA 50, EMA 200 and VWAP (restarts each UTC day). - **Bands and channels**: Bollinger Bands 20, 2; Keltner Channels 20, 2; Donchian Channels 20. - **Trend**: Ichimoku Cloud 9, 26, 52; Supertrend 10, 3; Parabolic SAR; ADX / DMI 14. - **Momentum**: RSI 14; MACD 12, 26, 9; Stochastic 14, 3, 3; Stoch RSI 14, 14, 3, 3; CCI 20; Williams %R 14; MFI 14. - **Volatility and volume**: ATR 14; On-balance volume. Moving averages, bands, channels, Ichimoku, Supertrend and Parabolic SAR draw over the candles. RSI, MACD, Stochastic, Stoch RSI, CCI, Williams %R, MFI, ADX / DMI, ATR and on-balance volume each get their own pane below the price, with guide levels such as 70 and 30 on RSI. ##### Drawing tools Press **Drawing tools** (the ruler and pencil at the start of the line above the chart) to show the tool rail on the chart’s left edge. It starts open on wide screens with a mouse and closed on phones. - **Cursor**: Select, move and reshape drawings. - **Trend line**: A line between two points. - **Ray**: A line from the first point through the second, running on to the chart’s edge. - **Horizontal line**: A line at one price, placed with one click. - **Rectangle**: A box between two corners. - **Fibonacci retracement**: The levels 0, 0.236, 0.382, 0.5, 0.618, 0.786 and 1 between two points: 1 at the first point, 0 at the second. - **Measure**: The price change, the change in percent and the number of bars between two points. - **Note**: A text label of up to 80 characters at one point. - **Magnet: snap to candle prices**: Points close to a candle’s open, high, low or close snap to it. - **Hide drawings**: Hides the drawings without deleting them. - **Remove all drawings**: Deletes every drawing on this market, with Undo. For two-point tools, click or tap the first point, then the second, or press, drag and release. A hint above the chart says what comes next; Escape or Cancel stops. ##### Editing and keeping drawings With the cursor, click a drawing to select it. A bar shows its name, five colours (Orange, Blue, Purple, Brown and Yellow), **Edit** for a note, **Remove drawing** and **Close**. Drag the drawing to move it, or drag one of its points to reshape it. On touch, the first tap selects and a drag after it moves. Double-click a note to edit it; a note left empty is removed. **Delete** or **Backspace** removes the selected drawing, and the message that follows offers **Undo**. > Drawings belong to the market and show on every interval, but they are kept in this browser only, not in your account. Another browser or device doesn’t see them, and clearing the site’s data deletes them. A market keeps up to 200 drawings, and drawings on up to 100 markets are kept: past that, the market you drew on longest ago is dropped. ##### Analyze an area On a perp’s chart, press **Analyze** in the chart’s toolbar, then drag across the chart over the time you want, or click where it starts and where it ends. The area is shaded on the chart and its analysis opens above your positions; on a phone it opens over the page. - **Totals**: Who pushed the price (aggressive buys and sells), the long and short positions opened and closed, the positions liquidated on each side, how much of what was opened is still held now, and where the new positions entered. - **Trader lists**: Each answers one question, sorted for it: Holding (who still holds what they opened here, largest first, and their profit now), Liquidation levels (whose liquidation is nearest the price: shorts above are forced buyers if it rises, longs below forced sellers if it falls), Buyers & sellers (who bought or sold the most on balance), Winners & losers (who made or lost the most here) and Liquidated. Click a column to sort by it. Each trader shows their position now (entry, leverage, liquidation price and its distance from the price), their name on Hyperliquid’s leaderboard and tags such as Vault, their rank by 30-day profit, or Market maker (bought and sold about the same, so their size says little). Click a trader to open their page. - **Labels**: The tag button next to a trader anywhere in Kokoah (these lists, market positioning, Discover, trader pages, the traders you follow) gives them a name of your own, shown instead of their address. Signed in, labels are saved to your account and show on every device; signed out, they stay in this browser until you sign in. - **Compare**: Compare picks a second area (B), shaded in another colour, and shows the two side by side: price change, aggressive buying and selling, longs and shorts opened, closed and liquidated, and open interest, with how B differs from A. Per hour evens out areas of different lengths. Remove B ends the comparison. - **Still holding**: Of what an address opened in the area, what it still holds: its position now, up to what it opened there. **Pick another area** replaces it; **Close**, or **Analyze** again, ends it. Totals cover areas of up to 30 days, and the address lists up to 7 days. > The numbers are exact, not estimates: Kokoah’s own Hyperliquid node records every trade on the exchange, with both addresses. If the node restarted during the area, the panel says when it may have missed trades. ##### Market layers and positioning On a perp’s chart, the **Market layers** button next to Analyze adds what Kokoah’s own Hyperliquid node sees across the whole exchange. Your choices are kept in this browser. - **Liquidation map**: Bars at the right edge at the prices where open positions would be liquidated, longer for more value: longs (green) below the price, shorts (red) above. A price moving into a large bar can speed up, as those positions are force-closed. - **Entry profile**: Bars at the left edge at the prices where open positions were entered. Many positions entered at one price often defend it, or sell when the price comes back to it. - **Liquidations on candles**: A circle on each candle with liquidations, larger for more value: longs liquidated under the candle, shorts over it. A burst of them often marks a flush or a squeeze. - **Buying pressure by order size**: A pane under the chart with four lines: the running total of aggressive buying minus selling, for orders under $10k, $10k to $100k, $100k to $1M and from $1M. It shows whether small or large orders are pushing the price. - **Positioning, whales and TWAPs**: A panel above your positions: how the accounts lean by count, how the leaderboard’s best traders and the $1M+ positions lean by value, average leverage, the nearest liquidations and the long share over time; the largest positions; the whale moves (orders of $100k or more that opened, closed, flipped, resized or liquidated a position, as they happen); and the TWAP orders filling now. - **Following a trader**: The bell next to a trader follows them: you’re alerted within seconds when they open, add to, cut, close or flip a position, or get liquidated. Alerts only; nothing is copied. Manage follows under Alerts. > Every long has a short on the other side, so by value the whole market is always even: what says something is how many accounts lean each way and how particular groups lean. Positions are read every 1 to 30 minutes by size, the largest every minute. ##### Your position and orders on the chart With an open position, the chart shows your **Entry** price and your **Liq.** (liquidation) price. Open orders show as lines: orders close together merge into one, and only those nearest the price carry a tag. Algo orders show their own lines. A dotted **Mark** line shows the mark price; the price at the right edge is **Last**, the latest trade. **My trades on the chart** chooses which of your fills show as small arrows: **Position trades** (the current position’s fills, the default), **All my trades** or **No trades**. The choice is kept in this browser. Click or tap the chart to use that price: it fills the ticket’s price, snapped to the market’s tick, and a market order switches to a limit order. The bell in the chart’s toolbar creates a [price alert](https://kokoah.com/docs/price-alerts) for the market. ##### Moving an order by dragging With a mouse, drag an order’s line to a new price. The order is modified in place at the new price, with the same size; a stop or take profit with a limit price keeps the same distance between its trigger and its limit. This works for a plain limit, stop or take-profit order that sits alone on its line (zoom in to split merged lines). Algo orders and spot orders can’t be dragged. The same checks as the ticket run before anything is signed: the price tick, the trigger’s side, the signer’s price band and Hyperliquid’s 10 USDC minimum. If one fails, the order stays where it was. A move of 1% or more, or one that would fill at once, asks you to confirm with **Move order** first. See [pre-trade checks](https://kokoah.com/docs/pre-trade-checks). #### Order book and trades https://kokoah.com/docs/order-book Depth, price grouping, sizes in coin or USD, the spread and recent trades, in Pro. ##### Reading the book The order book is part of **Pro**. From 1024 pixels wide it sits beside the chart with **Order book** and **Trades** tabs; on smaller screens, choose **Chart**, **Book** or **Trades** above the chart. Asks (offers to sell) are on top and bids (offers to buy) below. Each row shows the **Price**, the **Size** resting there and the **Total**, a running sum from the spread outward. The bar behind a row shows that total, with both sides on one scale, so you can compare depth at a glance. A level whose size just changed flashes. Between the two sides are the mid price and the **Spread**: the gap between the best ask and the best bid, in price and as a percent of the mid. Below the book, **B** and **S** compare the total bid size with the total ask size. Hyperliquid sends 20 levels a side; the panel shows as many as fit its height. The 5 best levels a side update about every half second, the deeper ones about every 3 seconds. After 3 seconds without an update, the book says it may be stale. ##### Price grouping and size unit The grouping list merges nearby prices into bigger steps, so you see more of the book at once. The first option is full precision; the others are the steps Hyperliquid offers at the current price. The ticket’s fill estimate uses the book only at full precision. **Size unit** shows sizes in the coin (for example BTC) or in USD, which is the size times the price. It applies to the book and to the trades. ##### Using a price from the book With a mouse or a keyboard, click a row to use its price: it fills the ticket’s limit price, and a market order switches to a limit order. Tab reaches the best bid, and the arrow keys move between rows. On touch screens the rows are too small to tap reliably, so they are for reading only: use **Mid**, **Bid** or **Ask** next to the ticket’s price instead. See [the order ticket](https://kokoah.com/docs/order-ticket). ##### Recent trades The **Trades** tab lists the market’s latest trades, up to 40 at a time, with the price, the size and the time. Buys have an up arrow and sells a down arrow, in your up and down colours. A large trade is highlighted: one worth at least 5 times the median of the recent trades, and never less than $10,000. ### Portfolio Balances, history, the trade journal, performance and your weekly review. #### Portfolio overview https://kokoah.com/docs/portfolio-overview Your equity, risk, performance, fees, funding and balances on one page, and how Portfolio is laid out. ##### The Portfolio page Open **Portfolio** to see your Hyperliquid account. You need to be signed in. The page has five tabs: - **Overview**: Your equity, risk, performance chart, fees, funding, fee tier and balances. This page describes it. - **Positions**: Your open positions, with their count on the tab. See [positions](https://kokoah.com/docs/positions). - **Performance**: Trade statistics, the daily PnL calendar, breakdowns and behaviour patterns. See [performance](https://kokoah.com/docs/performance). - **History**: Your trades, fills, orders, funding payments and transfers, with export. See [history](https://kokoah.com/docs/history). - **Funds**: Deposit, withdraw, send, and move money between your balances. See [deposits](https://kokoah.com/docs/deposits). Above the tabs are **Deposit** (**Add funds** while your account is empty) and, once you have funds, **Withdraw** and **Send**. The **⋯** menu has more actions: Receive, Move spot ↔ perps (standard accounts only), Convert stablecoins, Account type, Export CSV and Share PnL. The chip next to the title shows your account type: Standard or Unified. Select it to read what each type means or to switch. Switching takes one signature from your main wallet. > On a [linked phone](https://kokoah.com/docs/linked-devices), the header offers only Receive. Deposits from a wallet, withdrawals and sends stay on your computer. ##### Account summary The first card sums up your account in four numbers: - **Total equity**: Your trading account plus money in vaults, Earn (lent) and staked HYPE, as Hyperliquid counts it. The line under it says how much of it sits outside the trading account. - **Free margin**: Your equity minus the margin your open positions hold: what new trades can use. The line under it shows how much you can withdraw. - **Unrealized PnL**: The profit or loss of your open positions if you closed them now. - **Exposure**: The total value of your open positions, longs and shorts together, with the number of positions and your leverage. In a [unified account](https://kokoah.com/help/glossary#unified-account), your collateral lives in spot, so free margin and withdrawable are the spot USDC that is not on hold. ##### Risk Under the summary, a strip shows how close your account is to liquidation: - **Margin used**: The margin your positions hold, and its share of your equity. - **Leverage**: Exposure divided by equity. - **Nearest liquidation**: How far the mark price of your riskiest position is from its liquidation price, with the market and that price. It turns red under 5%. - **Cross margin ratio**: The maintenance margin of your cross positions divided by the cross account value. Hyperliquid liquidates cross positions when it reaches 100%. The label says Healthy under 50%, Caution under 80% and At risk from 80%. - **Unified account ratio**: Shown instead in a unified account: for each collateral token, the maintenance margin of cross positions divided by that token’s balance, less isolated margin. The highest one counts, and at 100% positions are liquidated. How liquidation works is explained in [margin and liquidation](https://kokoah.com/docs/margin-and-liquidation). ##### Performance chart The **Performance** card shows Hyperliquid’s own history of your account. Pick a period (**24h**, **7d**, **30d** or **All**) and turn on **Perps only** to leave spot out. - **Net PnL**: The change in Hyperliquid’s PnL history over the period, after fees and funding. - **Trading volume**: What you traded in the period, perps and spot unless Perps only is on. - **Realized net PnL**: The net PnL of the trades you closed in the period, from your [trade journal](https://kokoah.com/docs/journal). - **Funding**: Funding received minus funding paid in the period. Switch the chart between **Account value** and **PnL** (PnL since the start of the period). Hover the chart, or focus it and use the arrow keys, to read a point. **Show as a table** lists the values. > Net PnL follows Hyperliquid’s account history, while Realized net PnL counts only the trades you closed, so the two can differ. ##### Fees, funding and fee tier **Fees paid** adds up every fill in the chosen period, open positions included: **Hyperliquid fees**, **Kokoah fees**, the total, and your realized PnL before fees. Hyperliquid charges its exchange fee; the Kokoah fee is added on top. **Funding** shows the hourly funding payments you received and paid in the period, and the net. When the funding rate is positive, longs pay shorts. See [funding](https://kokoah.com/help/glossary#funding) in the glossary. **Fee tier** shows your Hyperliquid rates, which Hyperliquid sets from your 14-day volume, your daily volume, the Kokoah fee next to them, discounts and fee trials. The Kokoah fee is not discounted. See [fees](https://kokoah.com/docs/fees). ##### Balances, vaults and staking **Balances** lists each perps balance (in a standard account, one per HIP-3 market group), your spot tokens, money in vaults, Earn and staked HYPE, your total equity and your open positions. A token without a price yet is left out of the total and named under the card. When you hold tokens other than USDC, **Spot balances** shows them at their USDC price. See [spot and convert](https://kokoah.com/docs/spot-and-convert). **Vaults, Earn and staking** shows each vault’s equity, your PnL in it and when you can withdraw, what you lend in Earn, and your staked HYPE. On your main account it also lets you act: - **Deposit into HLP**, Hyperliquid’s own vault: from 5 USDC, at most 10,000 at once and 25,000 in 24 hours. Your trading key signs it, and the signer shows the deposit once more and asks you to confirm there. Each deposit can be withdrawn after 4 days. HLP can lose money. - **Withdraw** from any vault you hold, back into your account, once its lock-up has passed. A withdrawal can close part of the vault’s positions, and a vault with a leader keeps its share of your profit. - **Stake HYPE** with a validator, and **Unstake** it again. Your main wallet signs each step in plain words: moving HYPE into staking, delegating it, taking it back, and moving it to spot. A delegation is locked for 1 day; HYPE moved out of staking reaches spot after 7 days. Earn and deposits into other vaults stay on Hyperliquid: the card links there. Sub-accounts and phones linked without a wallet see these holdings without the buttons. > Your trading key can deposit into HLP only, after you confirm in the signer, at most 10,000 USDC at once and 25,000 in 24 hours; it can withdraw from any vault you hold back into your account. Staking is signed by your main wallet. Earn and other vaults stay on Hyperliquid. Vault leaders trade the money in a vault, and a withdrawal can close part of their positions. Kokoah earns nothing from vaults or staking. ##### Sub-accounts, hidden amounts and times If your wallet has Hyperliquid sub-accounts, an account switcher appears in the top bar. Portfolio always shows the account picked there, with its own balances, history, journal and performance. See [sub-accounts](https://kokoah.com/docs/sub-accounts). To hide amounts, for example while you share your screen, select the eye button (**Hide balances**) in the top bar, or turn on **Settings** (account menu) → Appearance → **Hide balances**. Amounts show as dots until you turn it off. Times follow **Settings** (account menu) → Appearance → **Time zone**: your local time or UTC. #### History https://kokoah.com/docs/history Every trade, fill, order, funding payment and transfer, with filters, CSV export and a tax-year file. ##### History views Open **Portfolio → History** and pick a view at the top (a list on phones): - **Trades**: Your round trips from open to close, with notes and statistics. See the [trade journal](https://kokoah.com/docs/journal). - **Fills**: Every execution of your orders, with prices, fees and realized PnL. - **Orders**: Every order you placed and what became of it. - **Funding**: Your hourly funding payments. - **Transfers**: Deposits, withdrawals, transfers, sends, liquidations, rewards and other changes to your balances. History needs a signed-in account and Kokoah’s services. Kokoah imports your history from Hyperliquid and keeps it, and adds the newest records live from Hyperliquid while the page is open. > Hyperliquid serves only your 10,000 most recent fills and 2,000 most recent orders. Kokoah keeps everything from the day it starts importing, but if your account had more than that before, the oldest ones can be missing. ##### Fills and fees Each row is one fill: a part of an order that executed. Next to the market, time, price and size, you see: - **Trade**: The direction Hyperliquid reports, such as Open Long or Close Short. - **Fee**: Hyperliquid’s fee for the fill, in the token it was paid in: USDC, or the token you bought on a spot buy. - **Kokoah fee**: The builder fee Kokoah added on top of Hyperliquid’s fee. - **Type**: Taker or Maker, and where the order came from: Kokoah, Guardian, AI ticket, Bot, Telegram, or Other app for orders placed outside Kokoah. - **Realized PnL**: The profit or loss Hyperliquid booked on a closing fill, before fees. Opening fills show a dash. - **Transaction**: Explorer opens the transaction in Hyperliquid’s explorer, in a new tab. On phones, some columns are hidden. The Overview and Performance tabs add up both fees for you. The rates are explained in [fees](https://kokoah.com/docs/fees). ##### Orders Each order shows its market, when you placed it, its side and type, price, size and status: Filled, Open, Triggered, Canceled or Rejected. - A trigger order shows its trigger price, and a market order shows Market. - A partly filled order shows its size and how much is still open. - A take-profit or stop-loss for the whole position shows Position as its size: it closes whatever is open when it triggers. - Details gives Hyperliquid’s reason in plain words, when the order last changed, its time in force and where it came from. - A Reduce only badge marks an order that can only make a position smaller. Trigger orders are explained in [take-profit and stop-loss](https://kokoah.com/docs/tp-sl). ##### Funding and transfers **Funding** lists each hourly payment: the market, the hour, your position then, the rate and the payment, positive when you received it. A card above the list totals what you received, what you paid and the net, for the payments shown with your filters. **Transfers** lists deposits, withdrawals, internal transfers, spot transfers, sends, sub-account transfers, spot / perps transfers, liquidations, rewards and other entries such as vault deposits and staking transfers. Each row shows the other address or the vault (for example HLP), the amount, any fee, the change to your USDC balance and an Explorer link. What funding is: see [funding](https://kokoah.com/help/glossary#funding) in the glossary. ##### Filters The filters sit next to the views (on phones, under **Filters**). They apply to the list and to the export: - **Date range**: All time, Last 24 hours, Last 7 days, Last 30 days, Last 90 days, or Custom dates with a From and To day in your display time zone. - **Market**: Type a market such as BTC; suggestions appear as you type. Only that market is listed. - **Side**: Buys or Sells for fills, Buy orders or Sell orders for orders, Long positions or Short positions for funding, and Money in or Money out for transfers. - **Entry type**: Transfers only, instead of Market: one kind of entry, such as Deposits or Sub-account transfers. - **Tag**: Trades only, instead of Side: round trips with exactly that tag. **Clear** removes every filter. Fills, orders, funding and transfers show 25 rows a page, and **Load older records** fetches more from Kokoah. ##### Export CSV and tax year **Export CSV** downloads the current view with its date range, market, side, entry type and tag filters, newest first. Times in the file are in UTC. A fills, orders, funding or transfers file holds at most 100,000 rows. 1. For taxes, select **Tax year** next to Export CSV. 2. Pick a year, from 2023 to this year. 3. Select **Download CSV**. The tax-year file holds every fill (spot included), funding payment and transfer of that calendar year, oldest first, with Hyperliquid and Kokoah fees in separate columns. The year and each record’s date follow your display time zone. A year with more than 100,000 records of one kind can’t go into one file: export fills, funding and transfers by date range instead. > Amounts are as Hyperliquid reports them. The file is a record, not tax advice. ##### Import and sync Under the list, Kokoah says how far the import of your history has come. While it runs, recent records still come live from Hyperliquid. When it is done, it says Full history imported, with the time of the last update. **Sync older history** asks Kokoah to check Hyperliquid again now. You can ask once every 5 minutes per account, and a sync of the main account also syncs its sub-accounts. New records appear as they arrive. Times are in your display time zone: **Settings** (account menu) → Appearance → **Time zone**. #### Trade journal https://kokoah.com/docs/journal Round trips from open to close, with net PnL after fees and funding, statistics, notes and tags. ##### Round trips The journal is in **Portfolio → History → Trades**. Kokoah builds it from your fills on its own: each row is a round trip, one position in one market from the fill that opens it until it is flat again. - Adding to the position grows the round trip; closing part of it records an exit. - The round trip ends when the position is back to zero. Until then it shows Open. - A fill that flips the position, from long to short or back, ends the round trip and opens a new one with the rest of the fill. That fill’s fees are split between the two by size. - Only perps count. Spot trades are not in the journal. Each account, every sub-account included, has its own journal. The newest round trips come first; **Load older trades** shows more. > If part of a position’s history is missing, for example fills older than the 10,000 that Hyperliquid still serves, the round trip starts where the history picks up, and Kokoah works out its entry price from the PnL Hyperliquid booked on the exits. ##### Prices and PnL - **Entry → exit**: The size-weighted average price of the opening fills (adds included), and the same for the closing fills. The exit shows a dash until the first close. - **Size**: The largest the position got during the round trip. - **Fees**: Hyperliquid fees plus Kokoah fees of every fill in the round trip. - **Funding**: Every funding payment in that market while the round trip was open: positive when you received it, negative when you paid. - **Net PnL**: Realized PnL − Hyperliquid fees − Kokoah fees + funding. Realized PnL is the profit or loss Hyperliquid books when you reduce or close a position, before fees. An open round trip shows only what is realized so far; its unrealized PnL is not included. ##### Statistics The cards above the list count the round trips closed in the date range and market you picked: - **Trades**: How many closed, and how many were won and lost. A trade that ends at exactly zero net counts as neither. - **Win rate**: The share of closed trades with a net profit. - **Net PnL**: The sum of their net PnL, after fees and funding. - **Fees**: All their fees, split into Hyperliquid and Kokoah. **More statistics** adds expectancy (the average net PnL per trade), profit factor (winning trades’ total divided by losing trades’ total; none when nothing lost), average win, average loss and funding, and tables by market, by weekday and by hour. Weekdays and hours are in UTC, by close time. Hold times, streaks and longer periods are on [Performance](https://kokoah.com/docs/performance). ##### Notes and tags 1. In **Portfolio → History → Trades**, select the notebook button in a round trip’s row. 2. Write your note: why you entered, what you saw, what you would do differently. Up to 5,000 characters. 3. Add tags separated by commas, for example: breakout, news. Up to 20 tags of up to 40 characters each; a repeated tag is saved once. 4. Select **Save notes**. Notes and tags show in the Notes column. Type a tag in the **Tag** filter to list only round trips with exactly that tag, and compare your results by tag in [Performance → Breakdown](https://kokoah.com/docs/performance#breakdown). > Kokoah stores your notes with your account. They go to an AI provider only to write a [weekly review](https://kokoah.com/docs/weekly-review): when you ask for one in the app, or for the Monday review in Telegram when that is on. ##### Filters and export Trades uses the same **Date range** and **Market** filters as the rest of History, plus **Tag**. A round trip falls in the range by its close time, or by its open time while it is still open. **Export CSV** downloads the round trips in the date range and market, with prices, fees, funding, net PnL, duration, notes and tags. The tag filter does not apply to the file. See [export](https://kokoah.com/docs/history#export). The file also has an R multiple when Kokoah finds the first stop-loss order you placed for the trade: net PnL divided by the risk to that stop, which is the distance from entry to stop times the size. #### Performance https://kokoah.com/docs/performance Trade statistics, the daily PnL calendar, breakdowns, fees and funding, and patterns that often cost money. ##### Period and statistics Open **Portfolio → Performance** and pick a period: **30 days**, **90 days** (the default), **This year** or **All time**. Statistics, the breakdown, fees and funding and behaviour flags follow it; the calendar has its own month. - **Net PnL**: Net PnL of the trades closed in the period, after fees and funding. - **Win rate**: The share of closed trades with a net profit, with the number won and lost. - **Profit factor**: Gross profit divided by gross loss. Above 1, your winners earned more than your losers lost. - **Expectancy**: The average net PnL per trade. - **Average hold, Winners held, Losers held**: The average time from open to close, for all trades, for winners and for losers. - **Longest streaks**: The most winning and losing trades in a row, by close time. Trades are the closed round trips of your [trade journal](https://kokoah.com/docs/journal), perps only. The calendar and the fees table also count spot fills. The page ends with the [weekly review](https://kokoah.com/docs/weekly-review). ##### PnL calendar The calendar shows one month; use the arrows to move between months. Each day with activity shows its net PnL, green for a gain and red for a loss. Above it you see the month’s net PnL, winning days out of active days, and the best and worst day. Daily net PnL = realized PnL from fills − Hyperliquid and Kokoah fees + funding, by day in your display time zone, in USD. Unrealized PnL, transfers and vaults are left out, so it is not the change in your account value; the chart on Overview shows that. Spot counts too: a spot sale adds the PnL Hyperliquid books for it, and a spot buy’s fee, paid in the token you bought, counts at the fill price. Select a day to see its totals (realized PnL, both fees, funding and net) and its fills. A busy day lists its latest 500 fills; all of them are in **History → Fills**. ##### Breakdown **Breakdown** groups the trades closed in the period by **Market**, **Side**, **Origin** or **Tag**, with the trades, win rate, average hold, profit factor, fees and net PnL of each group. - **Origin**: Where the opening order came from: Manual, Guardian, AI ticket, Bots, Telegram or Other apps. - **Tag**: Your journal tags. A trade with several tags counts once in each; trades without tags are grouped as Untagged. Add tags to your trades in the [trade journal](https://kokoah.com/docs/journal#notes-and-tags). ##### Fees and funding This card covers every fill and funding payment in the period, open positions included, not only closed trades: Hyperliquid fees, Kokoah fees, funding paid and funding received. Group the table **By market** or **By month** to see fees, funding, volume and the number of fills of each. Months follow your display time zone. The rates are explained in [fees](https://kokoah.com/docs/fees). ##### Behaviour Kokoah looks for patterns in your trades that often cost money: - **Revenge trade**: A new trade in the same market within 15 minutes after a losing trade closed, with a larger size. - **Overtrading**: A day (UTC) with at least 10 trades and more than 3 times your average per active day. It needs at least 3 active days of history. - **Hold time**: You hold losing trades at least 1.5 times as long as winning ones. Checked from 5 closed trades in the period, with at least 2 wins and 2 losses. - **Streak**: Your longest losing streak in the period is 4 trades or more. Also checked from 5 closed trades. Revenge trade and overtrading flags show in the period they happened. **Dismiss** removes a flag for good. Hold time and streak notes change with your trades. #### Share PnL https://kokoah.com/docs/share-pnl Make an image of a trade’s result to post or send, showing only what you choose. ##### Where to find it - An open position: in **Positions**, open the row’s **⋯** menu and select **Share PnL**. The image shows its unrealized PnL and ROE. - A position you just closed: the result message has a **Share** button. The image shows the PnL of the closed part, before fees. - A closed trade: in **Portfolio → History → Trades**, select the share button in its row. The image shows the round trip’s net PnL, after fees and funding. **Share PnL** in the Portfolio **⋯** menu takes you to History, where you pick the trade. ##### What the image shows The image is a 1200 × 630 PNG in Kokoah’s colors, in the app’s language. It shows: - The market and side. - The result in USD, green for a gain and red for a loss, and the ROE for an open position. - The position size. - The Kokoah logo, the time it was made and the line “Past performance does not predict future results.” It never shows your address, your balance or your account value. The preview updates as you change the options. ##### Choose what to show - **Show PnL in USD**: Turn it off to hide the dollar amount. The image then shows the ROE instead, or “My trade on Kokoah” when there is no ROE. - **Show position size**: Turn it off to leave the size out. - **Add my invite code and QR code**: Adds your invite code and a QR code for your invite link, and the footer says you may earn from invites. Offered only where invite rewards are available. See [invite](https://kokoah.com/docs/invite). > With **Hide balances** on, the dialog opens with the amount and the size turned off. ##### Copy, download or share - **Copy image**: Copies the image, to paste into a post or a chat. Shown when your browser can copy images. - **Download**: Saves the image as kokoah-pnl.png. - **Share**: Opens your device’s share sheet. Shown on devices that can share files, such as most phones. Kokoah makes the image in your browser. It doesn’t upload or keep it. #### Weekly review https://kokoah.com/docs/weekly-review An AI-written review of one week of closed trades, with every number checked against your data. ##### What it is At the bottom of **Portfolio → Performance**, the **Weekly review** card turns one week of your closed trades into a short review: - A summary of the week in one or two sentences. - What worked and what didn’t: up to 3 points each. - 3 suggestions about your own process, such as risk per trade, stop losses, position size, how often you trade or re-entering after a loss. It is written from your closed trades, their statistics, your behaviour flags and your journal notes. It only writes text: it never trades, predicts markets or tells you to buy or sell anything. It is not financial advice. ##### Ask for a review 1. Pick **This week** or **Last week**. Weeks run Monday to Sunday in your display time zone. 2. Select **Review this week** or **Review last week**. 3. Wait while it is written. The line above the review shows the week, the number of closed trades, the net PnL, the win rate and how many notes it used. A review needs at least one closed trade in the week; otherwise nothing is sent to the AI. It is written in the app’s language and covers the account picked in the top bar. > The card says AI is off when Kokoah’s server has no AI provider set up. Everything else on Performance works without it. ##### What’s computed and what the AI writes Kokoah computes every number in code from your journal: trades won and lost, win rate, net PnL, fees, funding, averages, profit factor, hold times, streaks, the previous week for comparison, results by market, side and origin, and the week’s behaviour flags. The AI only writes the words around them. Kokoah then checks every number in the answer against those facts. An answer with a number that isn’t in them is sent back once; if the second answer fails too, you see “The AI could not write a review that passed the checks. Try again.” In a busy week, the AI sees the 40 trades with the largest net PnL one by one; the statistics still cover every trade. A line under the review says it was written by AI and names the provider, the model and when it was written. ##### What is sent When you ask, the week’s closed trades, their statistics, your behaviour flags and your journal notes and tags go to the AI provider named under the review. Notes are cut to 200 characters, and anything that looks like a key is removed first. While **Hide balances** is on, the review text stays hidden. Reviews count toward your AI limits; see [AI principles](https://kokoah.com/docs/ai-principles). ##### Saved reviews Kokoah keeps one review per account, week and time zone. Asking again shows the saved review, without a new AI request. If that week’s trades or notes changed after the review was written, a message says so. Select **Update review** to write it again. ##### Weekly review in Telegram With Telegram linked, Kokoah writes last week’s review for your main account every Monday at your morning brief’s time and time zone, even when the brief itself is off (08:00 UTC if you never set up the brief). See [Telegram briefs](https://kokoah.com/docs/telegram-briefs). Turn it on or off in **Settings** (account menu) → Telegram, under the assistant: **Weekly review**. It is on by default and runs only while **Trade reviews** is not Off. The message holds the summary and up to 2 points each on what worked and what didn’t. It lands in your inbox, and in Telegram while **Alerts in Telegram** is on. A week without closed trades sends nothing. ### Funds Deposits, withdrawals, sending and receiving, sub-accounts and the address book. #### Deposits https://kokoah.com/docs/deposits Bring USDC to Hyperliquid from Arbitrum, Base or Ethereum, and follow it until it’s credited. ##### How a deposit works Open **Portfolio → Funds** and choose **Deposit**. The **Deposit** or **Add funds** button in the Portfolio header lands there too. Kokoah picks the recommended route and shows what you receive, the fee and when it arrives before you sign anything. 1. Enter the amount. Max fills in your wallet balance on that network (for ETH it keeps some back for gas). 2. Check the preview: **From**, **You receive**, **Fee** and **Arrives in**. **Details** shows the least you’ll get and every fee. 3. Press **Deposit**. Your wallet asks for one or two confirmations, and the step waiting for you says “check your wallet”. 4. Follow the transfer under **Recent transfers**. It counts as credited only once your Hyperliquid account shows it. The recommended route is the one that credits the most USDC; when two are about equal, the faster one wins. To choose another network, token or route, open **Other ways**. The USDC lands in the perps balance of a standard account, or in the spot balance of a unified account (its one balance). An empty account also shows the same form in the order ticket, as the Add funds to start card. ##### Routes, networks and minimums Kokoah has four deposit routes. Which ones you can use depends on the network and the token you send from. - **Circle CCTP**: USDC from Arbitrum, Base or Ethereum. Circle’s fast-transfer fee and the HyperCore forwarding fee come off the amount, so the amount must be more than those fees. About 1 minute, about 2 from Ethereum. From Arbitrum it takes one signature and one transaction, with no approval; from Base and Ethereum you first approve exactly the amount. - **Hyperliquid bridge (legacy)**: USDC on Arbitrum only, always to your own perps balance, usually within a minute. No fee besides network gas. The minimum is 5 USDC: smaller deposits are never credited and are lost, so Kokoah blocks them. - **Relay**: Mainnet only. USDC, ETH or USDT, depending on the network, swapped to USDC on the way. You get at least the quoted minimum, or Relay refunds you on the source network. Quotes come through Kokoah’s server. - **Across**: Mainnet only. USDC, ETH or USDT, depending on the network, swapped to USDC on the way. If Across can’t fill in time, it refunds you on the source network. Relay and Across have no fixed minimum, but an amount too small for their fees gets no quote, and the route list says why. Quotes refresh on their own and an expired quote is never signed. Before you sign, Kokoah checks each route’s transaction: it must name your own address, and any token approval is for exactly the amount. When Across sends USDC through Circle CCTP, the minimum shown is what the transaction itself guarantees: the amount less the largest fee it allows. Kokoah refuses the quote when that fee is above the fees Across quoted, when Across promises more than the transaction guarantees, or when the transfer asks for a finality Circle doesn’t offer. ##### Your wallet and gas Deposits come from your main wallet, the one you signed in with. It signs the transactions on the source network and pays their gas, so keep a little ETH there. The trading key never takes part. **Your own wallet**: the form starts from the network your wallet is on when Kokoah supports it, so most deposits need no network switch. If your wallet is on another network, a warning offers to switch it. **Email wallet** (email, Google or passkey): it runs on Arbitrum. Send USDC and a little ETH for gas to your address on Arbitrum, then deposit from Arbitrum. See [Email wallet](https://kokoah.com/docs/email-wallet). Deposits aren’t available in these cases: - A smart-contract wallet: Hyperliquid accepts only signatures from a regular wallet key. - A phone linked without a wallet: deposit on your computer. See [linked devices](https://kokoah.com/docs/linked-devices). - An account or region that isn’t eligible. Withdrawals still work. See [eligibility](https://kokoah.com/docs/eligibility). ##### From an exchange or another account Below the Deposit button, **Show your address** opens your Hyperliquid address and its QR code. Another Hyperliquid account can send to it directly, and it arrives in seconds. See [Send and receive](https://kokoah.com/docs/send-and-receive#receive). From an exchange, withdraw to that address only if the exchange offers Hyperliquid (HyperCore) as the network by that name. Tokens sent on Arbitrum, Ethereum or any other chain land in your wallet on that chain; deposit them from there. Only deposits you start in Kokoah’s Deposit form appear in the transfer tracker. Everything that reaches your account is listed in **Portfolio → History → Transfers**. See [History](https://kokoah.com/docs/history). ##### Following a deposit Every deposit you start in Kokoah appears under **Recent transfers** on the Funds tab. **All transfers** opens the Transfer tracking page with every step, links to the explorer and the expected time. The list is kept in this browser: it survives a reload, but not a change of device. While the Funds tab or the Transfer tracking page is open, Kokoah checks the source network, Circle or the route provider, and your Hyperliquid ledger every few seconds. Only the ledger can mark a deposit as credited. If you speed up the transaction in your wallet, Kokoah follows the new one. - **Submitted**: The transaction was sent on the source network. - **Confirmed on source**: The source network confirmed it. - **Awaiting Circle attestation**: CCTP only: Circle waits for enough confirmations before it attests the transfer. - **Attested · forwarding**: CCTP only: Circle attested, and its forwarder mints the USDC on HyperEVM and passes it to Hyperliquid. - **In transit**: Relay or Across is filling the deposit. - **Delivered · awaiting credit**: Delivered on the Hyperliquid side; waiting for your ledger to show it. - **Credited**: Your Hyperliquid ledger shows the credit. Done. - **Refunded**: The provider sent the money back to you on the source network. - **Failed**: It stopped. The card says why and what to check. When a deposit is credited, refunded or fails, you also get a pop-up and a notice in your notifications. See [notifications](https://kokoah.com/docs/notifications). ##### When it takes longer Each card shows how long the transfer has taken and about how long it should take. Past twice the expected time plus 2 minutes it’s marked **Slower than usual**, and the card explains what’s going on. - Still Submitted: open the source transaction from the card. If it was dropped, nothing left your wallet. Don’t send it again while it’s pending. - Circle settles it as a standard transfer: this takes about 15–20 minutes, for example when Circle’s fast-transfer allowance is used up. Your funds are safe and nothing needs doing. - Delivered but not credited: refresh your balance and contact support if it doesn’t appear. - Circle’s forwarder failed: the transfer can still be completed. Don’t send again; contact support with the source transaction. - Reverted or cancelled in your wallet: nothing was sent, apart from gas for a reverted transaction. If Hyperliquid’s ledger doesn’t answer, the Transfer tracking page says so, and credits show as soon as it answers again. > Never send a deposit again because it’s slow. Use **Get help with this transfer** on its card: the support form opens with the transfer’s reference filled in. #### Withdrawals https://kokoah.com/docs/withdrawals Move USDC from Hyperliquid to a wallet on Arbitrum, Base or Ethereum, and follow it until it arrives. ##### How to withdraw Open **Portfolio → Funds** and choose **Withdraw**, or press **Withdraw** in the Portfolio header. 1. Enter the amount, or press Max for everything you can withdraw. 2. Check the preview: **To**, **Network**, **Fee**, **Arrives** and **You receive**. By default the money goes to your own wallet on Arbitrum through Hyperliquid’s withdrawal. 3. For another network, route or address, open **Change destination**. 4. Press **Withdraw** and approve one signature in your main wallet. Withdrawals always leave your main account. If your money is in a sub-account, [move it to the main account](https://kokoah.com/docs/move-funds#sub-accounts) first. ##### What you can withdraw **Available** under the amount is what Hyperliquid lets you take out now. In a standard account it’s your perps **Withdrawable** amount, which leaves out the margin your open positions use. In a unified account it’s your USDC minus what open orders hold. Only USDC can be withdrawn. In a standard account, USDC in your spot balance must first [move to perps](https://kokoah.com/docs/move-funds#spot-perps). While balances are refreshing, Kokoah waits instead of signing an amount it can’t verify. Withdrawals skip the eligibility check: you can always take your money out, even where deposits and trading aren’t available. ##### Routes, fees and timing - **Hyperliquid withdrawal**: To Arbitrum only. The fee is 1 USDC. Usually 3–5 minutes. - **Circle CCTP**: To Arbitrum, Base or Ethereum. Circle’s fee is read from its contract, and again right before you sign; the amount must be more than it. Usually 1–3 minutes, 2–5 minutes to Ethereum. The fee comes off the amount: **You receive** shows what arrives. You need no gas on the destination network. If Circle’s fee can’t be read, CCTP withdrawals pause until it can; press **Retry**. The first withdrawal of a new Hyperliquid account also pays a one-time 1 USDC activation fee. ##### Checking the destination Leave the address as it is to withdraw to your own wallet. Under **Change destination** you can pick one of your [saved addresses](https://kokoah.com/docs/address-book) or paste another one. For any address that isn’t yours, Kokoah shows a warning and asks you to tick **I verified the complete address and supported network.** The warning is stronger when the address looks like one you withdrew to before (the same first or last four characters), a common address-poisoning trick. > Withdrawing to an exchange? Check that it accepts USDC on that network. Some exchange deposit addresses don’t support every route, and some exchanges don’t credit deposits sent by a contract. ##### What you sign Your main wallet signs one Hyperliquid message it can show you in plain text, with the destination address and the amount. Nothing else is signed and no transaction is sent from your wallet. The trading key can never withdraw or send funds. That’s also why a phone linked without a wallet can’t withdraw: use your computer. See [trading keys](https://kokoah.com/docs/trading-keys). ##### Following a withdrawal Once Hyperliquid accepts it, the withdrawal appears under **Recent transfers** and on the Transfer tracking page with these steps: - **Accepted by Hyperliquid**: Hyperliquid took the signed request. - **Debited from your Hyperliquid balance**: Your ledger shows the money leaving. The badge reads Debited · on its way. - **Bridge payout or Circle mint**: The USDC is paid out on Arbitrum by Hyperliquid’s bridge, or minted by Circle on the destination network. - **Received**: Kokoah found the USDC arriving at the destination address. The withdrawal is Completed, and you get a notice. A withdrawal Hyperliquid rejects never becomes a row: the error shows in the form. If Hyperliquid doesn’t answer at all, the row shows Unconfirmed. Check your balance before you withdraw again; after 5 minutes with no debit in your ledger, it most likely wasn’t applied. > If a debited withdrawal is slow, don’t send it again. Use **Get help with this transfer** on its card. #### Send and receive https://kokoah.com/docs/send-and-receive Send USDC or other tokens to another Hyperliquid account in seconds, and share your address to receive. ##### Sending to another Hyperliquid account Open **Portfolio → Funds** and choose **Send**, or press **Send** in the Portfolio header. A send moves funds between Hyperliquid accounts: no bridge, no gas, and it arrives in seconds. 1. Enter the recipient’s Hyperliquid address (0x…, 42 characters), or choose one of your saved addresses. 2. In a standard account, choose **From**: **Perps** (USDC) or **Spot** (USDC or any spot token you hold). A unified account sends from its one balance. 3. Enter the amount and read the checks under it. 4. Press **Send** and approve one signature in your main wallet. The recipient gets the funds in the same kind of balance they left: from your perps to their perps balance, from your spot to their spot balance. Sends leave your main account. To move money between your own balances or sub-accounts, use [Move funds](https://kokoah.com/docs/move-funds). ##### Checks before you sign Kokoah asks Hyperliquid about the address and compares it with your history on this device. Some findings block the send; others ask you to tick **I checked every character of the address with the recipient.** - **Blocked**: The zero address; your own address (use Move spot ↔ perps); another account’s trading key (API wallet); a vault (vault deposits happen on Hyperliquid’s vault page). - **Lookalike**: The same first four or last four characters as a saved address, a past send or a past withdrawal, but a different address. Scammers plant these in your history. You must confirm. - **Exchange**: You saved the address as an exchange, or withdrew to it before. Exchanges usually don’t see Hyperliquid sends: use Withdraw for them. - **Saved less than 24 hours ago**: New saved addresses stay untrusted for a day. Confirm the address with its owner another way first. - **Filled in by a link**: A link filled in an address you haven’t saved. Send only if you know whose it is. - **New account**: The address has never been used on Hyperliquid. The first transfer to it pays a one-time 1 USDC activation fee, so send more than that. - **First send**: You haven’t sent to this address from this device before. For a larger first USDC send, Kokoah suggests a test first: 1 USDC, or 2 USDC to a new account. Ask the recipient to confirm it arrived, then send the rest. If Hyperliquid can’t be reached, the form says it couldn’t check the address: check it yourself with extra care. ##### Fees and what you sign A send has no fee, except the one-time 1 USDC activation fee when the recipient’s account is new. It arrives in seconds. Your main wallet signs one message that shows the recipient, the token and the amount in plain text. The trading key can never send funds. **A send can’t be undone.** Sends skip the eligibility check, so a restricted account can always move funds out. Smart-contract wallets and phones linked without a wallet can’t send. After a send to an address you haven’t saved, Kokoah offers **Save address** so you recognise it next time. See [Address book](https://kokoah.com/docs/address-book). ##### Receiving: your address Choose **Portfolio → More → Receive**, or **Show your address** in the Deposit form. You see your Hyperliquid address with a QR code and **Copy address**. On a linked phone, **Receive** is in the Portfolio header. Your Hyperliquid address is your main wallet’s address. Showing it signs nothing. Sends you receive don’t appear in the transfer tracker. Find them in **Portfolio → History → Transfers**. ##### Who can send to your address - **Hyperliquid accounts** can send any Hyperliquid token with Send. It arrives at once. - **Exchanges**: choose Hyperliquid (HyperCore) as the withdrawal network only if the exchange offers it by that name. - **Arbitrum, Ethereum, HyperEVM or other chains**: tokens sent there stay in your wallet on that chain, not on Hyperliquid. [Deposit](https://kokoah.com/docs/deposits) them to bring them over. #### Move funds https://kokoah.com/docs/move-funds Move USDC between your spot and perps balances, and between your main account and its sub-accounts. ##### Between spot and perps A standard account has two USDC balances: perps, the margin for perpetuals, and spot. A unified account has one balance and needs no moves; you choose the type in **Portfolio → More → Account type**. Open **Portfolio → Funds** and find **Move between spot and perps**, or choose **Portfolio → More → Move spot ↔ perps**. Enter the USDC amount, then press **Spot → perps** or **Perps → spot**. It takes one signature in your main wallet and no eligibility check. Balances update in a few seconds. ##### Between your main account and a sub-account Choose **Move funds between accounts** in the account switcher in the top bar, or **Move funds** in **Settings** (account menu) → Sub-accounts. The order ticket of an empty sub-account and the Funds tab offer it too while a sub-account is active. One side is always your main account. Pick **From** and **To**, enter the USDC amount and press **Move**. The line under the amount shows what can leave the From account now: its perps withdrawable amount, or its free USDC in a unified account. Funding a sub-account needs an eligible account; moving money back to the main account always works. After a move into a sub-account, the confirmation offers to switch to it. See [Sub-accounts](https://kokoah.com/docs/sub-accounts). ##### What you sign - **Spot ↔ perps**: A USD class transfer: the amount and the direction. - **Main account ↔ sub-account**: A send that names where the money goes, the sub-account it leaves (empty for the main account), the token and the amount. Both are readable messages your main wallet signs and can show you. Kokoah never asks your wallet to sign Hyperliquid’s own sub-account transfer, because the wallet can only show that one as a code. Your trading key can never move funds between accounts, and a phone linked without a wallet can’t either: move funds on your computer. See [trading keys](https://kokoah.com/docs/trading-keys). ##### Where moves show up Moves settle at once, so they don’t go through the transfer tracker. **Portfolio → History → Transfers** lists them with your other Hyperliquid transfers. See [History](https://kokoah.com/docs/history). #### Sub-accounts https://kokoah.com/docs/sub-accounts Trade separate strategies in Hyperliquid sub-accounts: switch between them, fund them and give each its own limits. ##### What a sub-account is A sub-account is a separate Hyperliquid account that belongs to your main wallet. Each one keeps its own balance, positions, history, guardians and limits. It has no key of its own: your main wallet owns it and your trading key trades for it. **Settings** (account menu) → Sub-accounts lists your sub-accounts, or explains how to create the first one. Once you have one, an account switcher appears in the top bar. Hyperliquid allows at most 50 sub-accounts per main account. ##### Creating and renaming You create and rename sub-accounts on Hyperliquid, which allows them once your account has traded $100,000. In Settings → Sub-accounts, choose **Create a sub-account on Hyperliquid** (before your first one) or **Open Hyperliquid sub-accounts**; once you have one, the account switcher also has **Create or rename on Hyperliquid**. Hyperliquid opens in a new tab. Why there: Hyperliquid has your wallet sign these changes as a code the wallet can’t display. Kokoah only asks your wallet to sign messages it can show you. Kokoah reads your sub-accounts from Hyperliquid every few minutes and on every page load, and, while you have none, each time you come back to its tab. Names come from Hyperliquid; a sub-account without a name shows its short address. ##### Switching accounts Open the account switcher in the top bar and pick an account under **Switch to**, or press **Trade this account** in Settings → Sub-accounts. The workspace then shows and trades that account, and the top bar names it. Kokoah remembers your choice on this device, per network. A switch in one tab doesn’t change other open tabs, so an order you’re placing there never moves to another account. ##### Trading in a sub-account Orders for a sub-account are signed by the same trading key as your main account, so there is nothing extra to enable. Before signing, Kokoah’s signer checks on Hyperliquid that the address really is one of your sub-accounts. See [Enable trading](https://kokoah.com/docs/enable-trading). Positions, open orders, fills, history, the journal and guardians all follow the active account. ##### Funding a sub-account Deposits, withdrawals and sends always use your main account. To fund a sub-account, [move USDC from the main account](https://kokoah.com/docs/move-funds#sub-accounts); to take money out, move it back first. An empty sub-account’s order ticket shows **Move funds** instead of a deposit form. Moving funds needs your main wallet, so a phone linked without a wallet can’t do it. ##### Limits per sub-account In **Settings** (account menu) → Sub-accounts, open **Limits** under a sub-account to set its maximum order, maximum per day, maximum leverage, and whether new entries need a stop loss. Without limits of its own, a sub-account uses the main account’s; **Use the main account’s** removes its own. The signer’s baseline limits always apply. See [Limits](https://kokoah.com/docs/limits). Limits are saved on Kokoah’s server, and this device’s signer applies them before anything is signed. A linked phone can’t change them. #### Address book https://kokoah.com/docs/address-book Save the addresses you send to with a name, so sends and withdrawals can warn you about mistakes. ##### Saving an address Open **Portfolio → Funds** and press **Add** on the **Saved addresses** card. Give the address a name (up to 32 characters), paste the full 0x address and choose a type. - **Wallet**: A Hyperliquid account you or someone you trust controls. The card offers Send next to it. - **Exchange**: An exchange deposit address. Exchanges usually credit deposits only on other chains, so Kokoah points you to Withdraw. After a send to an address you haven’t saved, Kokoah offers **Save address**. You can’t save your own address. **Edit** changes the name or type; to change the address itself, remove the entry and save a new one. **Remove** can be undone from the pop-up. ##### The 24-hour wait A newly saved address stays untrusted for 24 hours. The card marks it **New** with the hours left, and a send to it asks you to confirm the address first, ideally with its owner another way. Editing an entry keeps the date you first saved it, so renaming never restarts or skips the wait. Once a saved wallet address is a day old, sends to it skip the first-send checks. ##### Where it’s used - **Send**: pick one under **Saved addresses**, or press **Send** next to it on the card. See [Send and receive](https://kokoah.com/docs/send-and-receive#send). - **Withdraw**: under **Change destination**, pick one as the destination. See [Withdrawals](https://kokoah.com/docs/withdrawals#destination). - **Checks**: your saved addresses, your past sends from this device and your past withdrawals are compared with every new recipient. ##### Warnings - **Lookalike**: The recipient shares the first four or last four characters with an address you used, but isn’t it. Scammers plant such addresses in your history. You must confirm before sending. - **Exchange**: A send to an address saved as an exchange asks you to confirm and suggests Withdraw instead. - **New**: Saved less than 24 hours ago. A send to it asks you to confirm. > The address book is a safety check, not a lock: your wallet can still sign a transfer to any address. ##### Stored on this device only Saved addresses live in this browser, per network and per account. They are never sent to Kokoah’s server, so they don’t follow you to another device or browser, and clearing the site’s data removes them. You can save up to 100 addresses per account. Kokoah also remembers your last 50 sends from this device for the first-send and lookalike checks. ### Alerts Price, step and account alerts, and where they reach you. #### Price alerts https://kokoah.com/docs/price-alerts Price levels, percentage moves and step alerts: how to set them, how often they notify and how to pause them. ##### Create an alert Alerts run on Kokoah’s servers, so they keep watching when the app is closed. You need to be signed in to create them. Alerts, bots, guardians, followed traders and automation need at least $10 in your Hyperliquid account (perps and spot together). Charts, market data, scans and AI reads are free for everyone. What you set up keeps running if your balance drops later; turning something back on needs the $10 again. - Open **Alerts** and use the **New alert** card. It starts with a price level; other types are under **More alert types** → **Alert type**. - Tap the bell in the chart toolbar, or choose **Alert…** in a position’s menu, for a quick price alert on that market. - On the [funding board](https://kokoah.com/docs/funding-board), one tap sets an alert for when a market’s funding flips sign. Price alerts use the mark price. Kokoah checks them every few seconds and never fires an alert on stale market data. You can have up to 100 alerts; traders you follow don’t count toward that. A price notice can end with a short “Why:” line built by Kokoah’s code: whether the whole market moved, notable funding, a jump in open interest or an important headline from the last two hours. When nothing stands out, there is no line. ##### Price level alerts Choose **Price crosses a level**, pick the **Market**, choose **Above** or **Below** and enter the **Price**. If the price is already past the level when you save, the alert waits for a real crossing instead of firing at once (unless it notifies **While true**). For a price level, the quick alert (the bell) asks only for a price. Until you pick **Above** or **Below** yourself, a price over the current one means above and a price under it means below. A quick alert notifies once and then turns itself off. For a move instead of a level, choose **Percentage move**: enter the **Move** in percent (above 0, at most 100) and the window in minutes (**Within**, from 1 to 1440, 60 by default). It fires when the mark price moved that much, up or down, compared with the price that many minutes ago. ##### Step alerts: every $X or X% Choose **Every step** (in the quick alert too) to hear about each move of a set size. **Step in** picks the unit: - **USD**: Round levels, multiples of the step: every $500 notifies at 84,000, 84,500 and so on. The step must be at least 0.1% of the price; the form shows the smallest step allowed. - **%**: A move of that percentage from the price at the last alert (from 0.25% to 50%). The first step counts from the price when the alert starts. **Direction** chooses which moves notify: **Both**, **Up** or **Down** (**Up or down** in the quick alert). - A jump through several levels sends one notice that names them. - With a USD step, a level crossed back the other way notifies again only after the price moved a quarter of a step past it, so a price wobbling around a level stays quiet. - At most 12 step notices an hour per alert. Past that, one notice says the alert is paused and when (in UTC) it resumes. - Step alerts have no notify or cooldown choice: they space themselves. > Spot pairs such as HYPE/USDC take price alerts too. In the **New alert** form they are listed for **Every step** only; use the bell on a spot chart for a price level. ##### Once, each time or while true **Notify** sets how often an alert tells you. It applies to every type except step alerts and order events. - **Once**: The first time it happens, then the alert turns itself off and the notice says so. - **Each time**: Each time the condition starts to hold. The alert re-arms only after the value has clearly moved back (for a price level, 0.2% of the level), so a price hovering around the level notifies once. This is the default in the form. - **While true**: Reminders for as long as the condition holds, at the interval you pick in Remind every: 1 min, 5 min, 15 min, 1 h, 4 h or 1 day. With **Each time**, **Cooldown between alerts** (under **More alert types**, or in **Edit**) is the least time between two notices: from 10 seconds to 7 days, 300 seconds by default. A notice that falls inside the cooldown is dropped, never sent late. ##### Pause, edit and delete **Your alerts** lists every alert with how it notifies and when it last fired. The switch on a row pauses it (it shows **Paused**) and turns it back on. The ⋯ menu has **Edit**, **Duplicate** and **Delete**. An alert set to notify once turns itself off after it fires. Turn it on again with its switch to reuse it. You can also turn an alert off from its notice in the inbox or in Telegram, and snooze a price alert for an hour in Telegram. See [turning off and snoozing](https://kokoah.com/docs/alert-delivery#turn-off). > Alerts you add from Telegram with `/alerts add` notify once. See [Telegram commands](https://kokoah.com/docs/telegram-commands). #### Account alerts https://kokoah.com/docs/account-alerts Alerts on your own positions and account: distance to liquidation, PnL, funding, margin and order events. ##### Which account they watch Create these in **Alerts** → **New alert** → **More alert types** → **Alert type**. They use the same [notify options](https://kokoah.com/docs/price-alerts#notify-options) as price alerts, except order events. **Distance to liquidation**, **Position PnL**, **Account margin** and **Order and position events** watch the account that is active when you create them: your main account, or the [sub-account](https://kokoah.com/docs/sub-accounts) you picked. The row then shows the sub-account’s name, and so does every notice. Editing an alert keeps the account it watches. **Funding rate** alerts watch a market, not an account. ##### Distance to liquidation Pick a **Market**, or **Any open position**, and enter **Distance to liquidation below** in percent. The distance is the gap between the mark price and the position’s liquidation price, as a percentage of the mark price. - Each position gets its own notice. The notice is marked important when the distance is under half your threshold: with a 10% threshold, under 5%. - With Each time, the alert re-arms once the distance is 1 percentage point past your threshold again. - Important notices skip quiet hours and the hourly limit. See [quiet hours](https://kokoah.com/docs/alert-delivery#quiet-hours). With a linked Telegram chat, the assistant’s help near liquidation also warns you, with options Kokoah computes, such as reducing the position or adding margin. See [the Telegram assistant](https://kokoah.com/docs/telegram-assistant). > An alert only tells you. To act for you, use a stop loss or a [guardian](https://kokoah.com/docs/guardians) such as a liquidation guard. See [margin and liquidation](https://kokoah.com/docs/margin-and-liquidation). ##### Position PnL Choose **Position PnL**, the **Market**, **Above** or **Below**, and the **Unrealized PnL** in USD. It may be negative: below -250 tells you when the position is losing more than $250. Without a position in that market nothing fires. With Each time, the alert re-arms once PnL is back by 5% of your level (at least $1). In Telegram, with trading from Telegram on, a PnL alert on a position in profit offers a button to move the stop to breakeven. See [trading from Telegram](https://kokoah.com/docs/telegram-trading). ##### Funding rate Choose **Funding rate**, the **Market**, **Above** or **Below**, and the **Hourly funding rate** in percent: 0.01 means 0.01% per hour. It may be negative. Funding alerts are for perpetual markets only. With Each time, the alert re-arms once the rate is back by 10% of your level (at least 0.0002% per hour). The quickest way is the bell on the [funding board](https://kokoah.com/docs/funding-board): it sets an alert for when the market’s funding turns positive or negative, with a one-hour cooldown. A market with a funding alert already shows it. ##### Account margin Choose **Account margin**, then what to **Watch**, **Above** or **Below**, and the level: - **Margin used**: The margin your positions use, as a percentage of the account value (above 0, at most 100). An Above alert that fires at 80% or more is marked as a warning. - **Free margin**: What you could withdraw right now, in USD. - **Change today**: The change in account value since the first check after 00:00 UTC, in percent. Enter -10 for a 10% drop. Deposits and withdrawals count as changes. With Each time, the alert re-arms once the value is back by 5% of your level (at least 1 point or $1). ##### Order and position events Choose **Order and position events** and tick the **Events** you want (all are ticked at first): **Filled**, **Partially filled**, **Canceled by the exchange**, **TP/SL triggered**, **Liquidated** and **Auto-deleveraged**. You get one notice per event, with no notify choice. The alert starts from the moment you save it, or turn it back on: older events are never replayed. > While Kokoah is open, fills, liquidations and exchange cancels also appear in your inbox straight from Hyperliquid, marked **Live from Hyperliquid**. To get them by push or Telegram while the app is closed, create this alert. #### Market alerts https://kokoah.com/docs/market-alerts Alerts on how a market is positioned: the best traders or whales flip side, one side gets crowded, liquidations pile up near the price, a large TWAP runs. ##### What they are Market alerts watch a market, not your account. They come from Kokoah’s own Hyperliquid node, which reads every large open position on the exchange: who is long or short, where each would be liquidated, and the TWAP orders filling now. Kokoah checks them every 5 minutes, for perps (not spot pairs). A notice arrives where your other alerts do ([inbox, push, Telegram](https://kokoah.com/docs/alert-delivery#channels)) and opens the market. It is for information only: nothing is ever traded for you. ##### Best traders or whales flip side - **Best traders**: The 200 accounts with the highest all-time profit on Hyperliquid’s leaderboard, vaults left out. - **Whales**: Positions worth $1M or more, whoever holds them. A group is on a side when at least 55% of the value of its positions is there. Between 45% and 55% it keeps the side it had, so a group hovering near even doesn’t notify again and again. The alert tells you when the group turns from long to short or back; its first check only notes the side. A group needs at least 3 accounts in the market. ##### One side gets crowded Notifies when your share (55% to 95%) of the accounts holding the market are long, or short. It counts accounts, not money: every long has a short, so by value a market is always even. It needs at least 20 accounts, and notifies again only after the share has fallen 3 points below your level. Crowded trades can unwind fast when the price moves against them. ##### Liquidations near the price Notifies when positions worth at least your amount ($100,000 or more) would be liquidated if the price moved your distance (0.1% to 10%): shorts above the price, longs below it. The distance is measured from the live price. Forced orders there can speed a move up. It notifies again once both sides are under 80% of your amount. ##### Large TWAP orders A TWAP is a large order split into slices over time: a steady buyer or seller until it ends. This alert notifies when one has filled at least your amount ($100,000 or more), in one market or in any. Each TWAP is one notice, at most 3 at once. The TWAPs already running when you create the alert are not sent. ##### Create one 1. The quick way: the bell next to a market in the [positioning panel](https://kokoah.com/docs/chart#positioning) or the [market scanner](https://kokoah.com/docs/market-scanner#what-it-shows). One tap creates the alert with defaults: the best traders or the whales flip side, 70% of accounts on one side, liquidations within 1% of the price, or a TWAP of $1M. 2. To choose the numbers: **Alerts → New alert → More alert types → Alert type**, then pick a market alert, set its fields and select **Create alert**. The liquidation alert from the bell starts at about one and a half times what sits within 2% of the price now (at least $1M). Every market alert can be edited, paused or deleted under Alerts like the others. A flip or a TWAP notifies once or each time; the others can also remind you while they stay true. ##### How often and which markets Kokoah reads the positions of every listed Hyperliquid perp every 5 minutes, plus the HIP-3 markets someone opened in the last 7 days and every market with a market alert. A market you add an alert on is read from the next round. > A reading older than 20 minutes never notifies (for example while the node catches up), so a late notice can’t describe an old market. #### Where alerts go https://kokoah.com/docs/alert-delivery Your inbox, push notifications and Telegram: how alerts reach you, quiet hours, limits and failed deliveries. ##### Inbox, push and Telegram Every alert goes to the same places. There is no channel choice per alert: turn push or Telegram on later, and alerts you saved before reach you there too. - **Inbox**: Always. Every notice is recorded in Alerts → Inbox, whatever happens to the other channels. - **Push**: On every device where you allowed notifications for Kokoah. - **Telegram**: When a Telegram chat is linked and Alerts in Telegram is on. Linking a chat turns it on. In the **Your alerts** card, a line such as “Alerts go to your inbox and this device.” says where they go now; **Change where** opens the settings. Set up Telegram in [Telegram setup](https://kokoah.com/docs/telegram-setup). ##### Push notifications Kokoah asks your browser for permission the first time you save an alert or follow a trader, never before. If you say no, the alert is still saved and notices go to your inbox. A browser doesn’t ask again after a refusal: allow notifications for Kokoah in the browser’s site settings, then save an alert. When push is on, the Alerts page shows **Push is on for this device** and a **Send a test** button. Signing out removes this device’s push, so it stops getting the account’s alerts. On iPhone and iPad, push works only when Kokoah is on the Home Screen: 1. Open Kokoah in Safari. 2. Tap the Share button (the square with an arrow). 3. Choose “Add to Home Screen”, then “Add”. 4. Open Kokoah from the new icon, sign in and save an alert. ##### The inbox Open **Alerts** → **Inbox**. It holds your alerts and account events, such as deposits, guardian actions and trading-key reminders, newest first. The tab shows how many are unread; quiet Hyperliquid news doesn’t count. - **View** opens what the notice is about (the market, the position or the order), **Mark read** marks one and **Mark all read** marks them all. - **Important** marks a critical notice, such as a position very close to liquidation. - **Live from Hyperliquid** marks a notice this app raised itself from Hyperliquid’s live feed; Kokoah’s copy replaces it when it arrives. ##### Turn off or snooze an alert - In the inbox, a notice from an alert that is still on has **Turn off alert**. - In Telegram, every alert message has **Turn off this alert**. Turn it on again in the app, under Alerts. - In Telegram, price alert messages also have **Snooze 1 h**: the alert stays quiet for an hour, then carries on. Snoozing is only in Telegram. - In the app, the switch on the alert’s row pauses it. See [pause, edit and delete](https://kokoah.com/docs/price-alerts#manage). ##### Quiet hours, muted events and the hourly limit These are in **Settings** (account menu) → **Notifications**. They change push and Telegram only; your inbox records everything at once. - **Quiet hours**: Push and Telegram messages wait until quiet hours end, then go out. Turned on, they start as 22:00 to 08:00 in your time zone; the time zone is under More notification settings. - **Maximum notifications per hour**: 30 by default. Once that many went out in the past hour, further push and Telegram messages are skipped, not sent later. - **Don’t push these events**: Event types you tick are never pushed or sent to Telegram. > Important notices, such as a position close to liquidation, ignore quiet hours and the hourly limit. A type you muted stays muted. More in [notification settings](https://kokoah.com/docs/notifications). ##### When a delivery fails If a push or Telegram message fails for a passing reason, Kokoah tries again with growing waits, starting at 30 seconds, up to 6 tries in all. Messages to one Telegram chat keep their order. - If a device’s push subscription has expired, Kokoah removes it. **Send a test** on the Alerts page shows whether any device still gets push. - If you block the Kokoah bot in Telegram, Kokoah unlinks the chat. Link it again in [Telegram setup](https://kokoah.com/docs/telegram-setup). Whatever happens to push or Telegram, the notice stays in your inbox. If alerts seem late for everyone, check the [status page](https://kokoah.com/status). ### Telegram bot Link a chat, use every command, trade with a PIN, ask the assistant and get briefs. #### Set up the Telegram bot https://kokoah.com/docs/telegram-setup Link a Telegram chat to your account, choose what arrives there and unlink it again. ##### Link a chat The Kokoah bot sends your alerts to a private Telegram chat and, if you turn it on, lets you check your account and trade from there. It runs on Kokoah’s services, so you need to be signed in. If Settings has no Telegram category, this server doesn’t offer Telegram. 1. Open **Settings** (account menu) → **Telegram**. 2. Press **Link Telegram**. Kokoah makes a one-time link. 3. Press **Open Telegram**, or **Copy link** and open it on the device where you use Telegram. In the chat with the bot, press **Start**. 4. Within a few seconds the card shows **Linked**, and the bot replies with the short address of the Kokoah account it linked. Check that address. If it isn’t your wallet, send `/unlink` in the chat right away. Right after linking, the card offers a morning brief in the chat. Press **Turn on** or **Not now**; you can change it any time (see [the morning brief](https://kokoah.com/docs/telegram-briefs#morning-brief)). > Link Telegram from the computer with your main wallet. A linked phone can’t create a Telegram link. ##### How the link works The link opens the bot with a one-time code in it. The code works once, for 10 minutes; the card shows until when. After that, press **Link Telegram** again for a new one. Kokoah stores only a hash of the code, and the bot never repeats it. Linking works only in a private chat with the bot. Groups, channels and messages from other bots are ignored. An account has one linked chat, and a chat belongs to one account. Linking a new chat replaces the old one, which stops getting your messages. A chat that is already linked to another Kokoah account isn’t switched by a new link: send `/unlink` in that chat first, then open the link again. Linking turns on **Alerts in Telegram** for you. **Trade from Telegram** always starts off, even if it was on for an earlier chat. > Treat the link like a password until it’s used: whoever opens it first within those 10 minutes links their chat to your account. If a chat you don’t know got linked, unlink it in the app. ##### What arrives in the chat With **Alerts in Telegram** on, the chat gets the notices that reach your inbox, for example: - Your alerts: price levels, moves and steps, funding, PnL, distance to liquidation, account margin and order events. - Fills, triggered take-profits and stop-losses, liquidation warnings, liquidations and auto-deleveraging. - Guardian and bot notices, deposits and withdrawals, keys about to expire, and Hyperliquid announcements that touch your positions or orders. - Traders you follow, and the assistant’s messages: help near liquidation, the morning brief, trade and weekly reviews, digests and top-trader moves. - Market pulse reports and headlines, if you turned them on. Two kinds skip the chat: the result of a trade you made from Telegram (the chat already shows it) and a PIN lockout. Both go to your inbox and your devices as a push instead, so a trade you didn’t mean to make gets noticed. Other Hyperliquid announcements stay in the inbox only. Notices and the bot’s buttons are in your Kokoah language; the bot’s own replies to commands are in English. Many alert messages carry buttons, see [buttons on alerts](https://kokoah.com/docs/telegram-trading#alert-buttons). ##### Choose where alerts go Alerts have no channels of their own: each notice goes to your inbox and to the channels you turned on for the account, including alerts you saved before you linked Telegram. These settings decide what reaches the chat: - **Alerts in Telegram**: In the Telegram settings. Off keeps the chat linked (and trading, if it’s on) but sends no notices there. Your inbox always records every notice. - **Don’t push these events**: In the Notifications settings. A checked event type is neither pushed nor sent to Telegram; the inbox still records it. - **Quiet hours**: Notices that aren’t critical wait until the quiet hours end. The morning brief still comes at the time you chose. - **Maximum notifications per hour**: Notices that aren’t critical and go over the cap are not sent to push or Telegram. The inbox keeps them. Critical notices, such as a position very close to liquidation, ignore quiet hours and the hourly cap. More in [notifications](https://kokoah.com/docs/notifications) and [alert delivery](https://kokoah.com/docs/alert-delivery). ##### Unlink the chat You can unlink from either side: - **In the app**: Press **Unlink** in the Telegram settings and confirm. - **`/unlink`**: In the chat: the bot asks you to Confirm within 60 seconds. - **`/stop`**: In the chat: unlinks right away. - **Blocking the bot**: If you block the bot in Telegram, Kokoah removes the link as soon as a message can’t be delivered. When the chat is unlinked: - Notices stop going to the chat. Your inbox and push notifications don’t change. - Trade from Telegram turns off, and the buttons on older messages stop working. - The AI assistant, the morning brief, reviews, digests, top-trader moves and help near liquidation stop, because they need a linked chat. - Your settings, including a trading PIN, stay saved. When you link again, trading from Telegram starts off. #### Bot commands https://kokoah.com/docs/telegram-commands Every command the Kokoah bot understands, with its arguments and examples. ##### How commands work Send commands in the private chat you linked. `/start` and `/help` also work before the chat is linked; everything else needs the link. `/help` shows the short list in Telegram, and the Telegram settings in the app have it under **Bot commands**. Coins are Hyperliquid’s tickers, in any case (btc works like BTC). Telegram covers Hyperliquid’s main perpetual markets only: no spot pairs and no HIP-3 markets. A message that doesn’t start with / goes to the [AI assistant](https://kokoah.com/docs/telegram-assistant) when you turned it on. Otherwise the bot points you to `/help`. Each chat can send 20 commands or button presses a minute and open 6 trade previews a minute. Past that, the bot asks you to slow down. > The bot answers commands in English. Its buttons, notices and the AI assistant use your Kokoah language. ##### Account and markets - **`/positions`**: Account value, free margin and each open position: side, size, leverage and margin mode, entry, mark, PnL with return on margin, and liquidation price. Up to 20 positions are listed, and the first 6 get a Close button. - **`/orders`**: Your open orders on the main perpetual markets (up to 20 listed), with a Cancel button for each coin (up to 5 coins) and Cancel all. - **`/pnl`**: Today (UTC) and this week (from Monday, UTC): realized PnL minus fees plus funding, with the number of fills, and the unrealized PnL of your open positions now. It counts the fills Kokoah has synced, usually within a minute. - **`/price BTC`**: Mark price and 24h change, mid and oracle price, funding per hour and per year, 24h volume, open interest and the market’s top leverage, with a Refresh button. These commands only read. Their Close and Cancel buttons open a trade preview, like the trading commands below. ##### Trading Trades need **Trade from Telegram** on. Each command shows a preview first and runs only after you press Confirm (and send your PIN, if you set one). See [trading from Telegram](https://kokoah.com/docs/telegram-trading). - **`/long BTC 100 5x sl 2% tp 4%`**: Opens or adds to a long with a market order: a $100 position at 5× leverage, with a stop-loss 2% below the entry and a take-profit 4% above it. Everything after the size is optional. - **`/short ETH 50 sl 3900`**: Opens or adds to a short with a market order: a $50 position with a stop-loss at 3900. Against an open long it reduces the long, or closes and flips it; the preview says which. - **`/close BTC`**: Closes the whole BTC position with a reduce-only market order. - **`/close BTC 50`**: Closes 50% of it (50% works too). The percent must be above 0 and at most 100. - **`/cancel BTC`**: Cancels every open BTC order, stop-losses and take-profits included. The preview warns you when it removes them. - **`/cancel all`**: Cancels every open order on the main perpetual markets. ##### Sizes, leverage, stops and take-profits - **Size**: The position size in USD, not the margin: 100, $100, 1,000.5 or 2k (2,000). Hyperliquid’s smallest order is $10, and the bot refuses more than $10,000,000 before any other check. The coin amount is rounded down to the market’s size step. - **Leverage**: A whole number with x, from 1x to 100x, given once, and never above the market’s maximum or your signed limit. Without it, the coin’s current leverage is used. A new leverage changes the market’s setting and keeps its margin mode (cross or isolated). - **sl and tp**: A price (72000 or 72,000.5) or a percent from the entry (2% or 2.5%, above 0 and below 100), each at most once. Both must sit beyond the current price by at least the market’s stop buffer (0.1% on BTC, up to 0.5% on thin markets), on the right side for your trade. - **Order type**: Commands place market orders that may fill up to 1% from the mid price. For a limit order, ask the AI assistant in your own words. The parts after the size can come in any order: `/long SOL 250 sl 3% 3x` works too. > If your signed limits require a stop-loss on new entries, add `sl` to every `/long` and `/short` that opens or adds to a position. ##### Alerts, bots and automation - **`/alerts`**: Lists your newest alerts (up to 15; followed traders aren’t included) and marks the ones that are off, with Remove buttons for the first 8. - **`/alerts add BTC above 72000`**: Adds a price alert. Use above or below; the word add can be left out. The alert notifies once, here, in the app and as a push. You can have up to 100 alerts. - **`/bots`**: Lists your running and paused bots. Pause stops a bot right away, and its resting orders stay on the book. Resume needs Trade from Telegram on and your Confirm, and runs the same checks as the app. - **`/pauseall`**: After your Confirm, every bot and guardian stops placing orders and Kokoah’s servers stop signing for you. Resting orders stay on the book. Resume in the app under Alerts → Guardians. To make other kinds of alerts (percent moves, steps, funding, PnL, account margin), use the [AI assistant](https://kokoah.com/docs/telegram-assistant#plain-language) or the Alerts page in the app. ##### Link and help - **`/start`**: Opened from the app’s link, it links the chat. Sent on its own, it says whether the chat is linked. - **`/help`**: The short list of commands. - **`/unlink`**: Unlinks the chat after your Confirm (within 60 seconds). - **`/stop`**: Unlinks the chat right away. See [unlinking](https://kokoah.com/docs/telegram-setup#unlink) for what changes. #### Trade from Telegram https://kokoah.com/docs/telegram-trading Turn on trading in the chat, confirm with a PIN, act on alerts and get help near liquidation. ##### Turn trading on or off Trading from Telegram is off by default. Turn on **Trade from Telegram** in **Settings** (account menu) → **Telegram**. Telegram trades are signed on Kokoah’s servers with your automation key, the same key guardians and bots use. So they need: - A linked chat. - Guardians turned on: an active automation key and signed automation limits (see [the automation key](https://kokoah.com/docs/automation-key)). Without them, the card shows **Turn on guardians first**. - Limits that include Telegram. If yours don’t yet, the switch opens **Add Telegram to your automation limits**: your wallet signs the same limits again with Telegram trades added (placing and canceling orders, and changing leverage). Every limit stays the same. Press **Sign and turn on**. - An allowed region check from the app (see [eligibility](https://kokoah.com/docs/eligibility)). - The computer with your main wallet: a linked phone can turn trading off but not on. Turning it off always works. It also turns off by itself when you link a chat (or a new one), when you unlink, and after 10 wrong PINs in a row. > If the switch says **Not available on this server**, this Kokoah server runs without automation: Telegram sends alerts but can’t trade. ##### Limits, checks and what the bot can’t do Every Telegram trade stays inside the automation limits you signed. The Telegram settings list them under **Limits Telegram trades use**: - **Largest order**: The most one order may be worth. - **Daily volume**: The total per day, shared with your guardians and bots. - **Leverage**: The highest leverage for a new or larger position. - **Markets**: All main markets, or the ones you picked. - **Stop-loss on new trades**: When required, every Telegram order that opens or adds to a position needs a stop-loss, within the distance you set, if any. **Change limits** opens Alerts → Guardians, where you edit the limits and sign them again. The bot checks them when it builds the preview, and Kokoah’s signer checks them again before anything is sent. A refusal names the limit and how to raise it. Before a preview, the bot also checks that trading from Telegram is on and not locked after wrong PINs, that automation isn’t paused, and that your automation key and signed limits are active. Telegram messages don’t tell Kokoah where you are, so trades also need a region check from the Kokoah app in the last 72 hours. If yours is older, open the app once and try again. > **What the bot can’t do**It can’t withdraw, send or transfer funds, change your keys or limits, turn trading on, set a PIN, resume guardians, add margin to a cross position, or trade spot, HIP-3 markets or sub-accounts. The automation key it trades with can’t withdraw at all. ##### Preview and Confirm 1. Send a command, press a trade button on a message, or ask the AI assistant. 2. The bot shows a preview: side and order type, size in USD and coins, leverage and margin, estimated fees (Hyperliquid’s at its base taker rate of 0.045% plus Kokoah’s builder fee), estimated liquidation price, the stop-loss with the loss at the stop, the take-profit, and warnings such as too little free margin. 3. Press **Confirm** within 60 seconds, or **Cancel**. 4. If you set a PIN, send it as a message within a fresh 60 seconds. The bot deletes it right away. 5. The preview message changes to show the result. The preview freezes the exact orders, and Confirm sends them once: pressing it twice can’t trade twice. A newer request replaces an open preview, and a preview that runs out says “Expired. Nothing was sent.” - **Done**: Hyperliquid accepted it. The message shows the fill price or the resting order. - **Not allowed**: Your signed limits refused it. The message says which limit. - **Failed**: Hyperliquid refused it, or it wasn’t sent. - **Outcome unknown**: The answer was lost on the way. Check `/positions` and `/orders` before you try again. Every result also reaches your inbox and your devices as a push (“From Telegram: …”), and the Telegram settings list it under **Recent activity**. Fills from Telegram show Telegram as their source in **Portfolio → History**. > Fees and the liquidation price in the preview are estimates. Your Hyperliquid fee tier may be lower than the base rate. ##### Trading PIN A PIN adds a second step to Telegram trades. It’s optional: set it under **Trading PIN** in the Telegram settings with **Set PIN**, from the computer with your main wallet (a linked phone can’t change it). - Six digits. Not one digit repeated (111111) and not a straight run up or down (123456, 654321). - Kokoah stores only a scrambled copy (a hash), never the PIN itself, and the bot deletes the message you type it in. - The bot asks for it before trades, cancels, stops, adding margin and resuming a bot, but not for `/pauseall` or `/unlink`. Wrong PINs lock trading from Telegram: - After 5 wrong PINs in a row, it locks for 15 minutes. The card shows **Locked until** with the time. - Each wrong PIN after that locks it again. - After 10 wrong PINs in a row, Trade from Telegram turns off until you turn it on again in the app. - The right PIN resets the count. Setting a new PIN or removing it ends a lockout. > Each lockout sends a critical notice to your inbox and devices. If you didn’t type those PINs, unlink Telegram in the app right away. ##### Check before I confirm With **Check before I confirm** on (the default), the preview of an order that opens or adds to a position shows up to three short checks, the most serious first. Code computes them from market and account data. They never block a trade; only your signed limits do. - **Normal daily range**: Liquidation would be within 1.5 times the coin’s average daily range over the last 14 days. - **No stop**: There’s no stop-loss while liquidation is within 15%. - **Overall exposure**: After the order, your positions in one direction would be worth more than 3 times your account value. - **Thin order book**: The book can’t fill a market order within its allowed slippage. - **Slippage**: A market order is expected to fill more than 0.3% from the mid price. - **Funding**: Funding runs against your side at more than about 20% a year. - **News**: An important headline on the coin in the last 2 hours. - **Top traders**: At least 70% of the top traders’ position value in the coin is on the other side. The same switch covers the app’s order confirm (see [pre-trade checks](https://kokoah.com/docs/pre-trade-checks)): turning it off in the Telegram settings turns the checks off in both places. ##### Buttons on alerts Alert messages in the chat carry buttons, so you can act without opening the app. These work while the chat is linked: - **Turn off this alert**: On every notice from an alert you set. The alert stays saved; turn it on again under Alerts in the app. - **Snooze 1 h**: On price alerts: that alert sends nothing for an hour. - **Position menu**: On price alerts for your main account’s perpetuals, labeled with the coin (for example “BTC position”). It shows the position now: size, leverage, entry, mark, PnL, liquidation distance and stops. Without a position it shows the price. The position menu has trade buttons of its own: - **Close 25%, Close 50%, Close all**: A reduce-only market order for that part of the position. - **Stop 2% away, Stop 5% away**: A stop-loss for the whole position at that distance from the mark price, filled as a market order when triggered. It replaces the position’s older stops. - **Stop to breakeven**: Shown when the position is in profit: moves the stop to your entry price, once the price is past it by at least the market’s stop buffer. With Trade from Telegram on, some alerts get trade buttons too: a liquidation warning gets **Reduce 25%**, **Reduce 50%** and **Close**, plus the stop and margin from [help near liquidation](https://kokoah.com/docs/telegram-trading#liquidation-help); a PnL alert in profit gets **Move stop to breakeven**. > Every trade button opens the usual preview, Confirm and PIN, and needs Trade from Telegram on. Alerts about sub-accounts get no trade buttons: Telegram trades act for your main account. ##### Help near liquidation **Help near liquidation** is on by default once a chat is linked. When a position on your main account comes within the warning distance of its liquidation price, you get one message with your options, and another at the critical distance. Set both in the Telegram settings: the warning from 2% to 50% (10% by default), the critical distance from 1% to 49% (5% by default) and below the warning. A position that opened closer than that, as a leveraged one does, is warned later: at half the distance it opened with, and critically at a quarter. A position whose stop for its whole size triggers before the liquidation price gets no message: the stop closes it first. The options are computed by code and are estimates: - Reduce 25% or 50%: for a cross position, the new liquidation price and its distance. - Add margin (isolated positions): the amount that doubles the distance, up to your free margin. For a cross position, the message suggests adding funds to the account in the app. - A stop halfway between the price and liquidation, with the result there. - Close the position. Each warning comes once. Only the critical message repeats: at most every 30 minutes, and only once the position moved at least 2 points further in. A level counts again after the position moved back out. Critical messages ignore quiet hours and the hourly cap. With Trade from Telegram on, the message has a button for each option, and each opens a preview first. Adding margin works only if your signed limits allow it. **Mute until closed** on the message, or **Mute this position** on the warning in your inbox, stops the messages about that position until it is closed. A new position in the same coin is watched again. #### AI assistant in Telegram https://kokoah.com/docs/telegram-assistant Ask about your account, and trade or set alerts in your own words, typed or as a voice note. ##### Turn on AI in Telegram Turn on **AI in Telegram** under **Assistant** in **Settings** (account menu) → **Telegram**. It’s off by default and needs a linked chat. The row is hidden when this server has no AI. Once it’s on, any message in the chat that isn’t a command goes to the assistant. It replies in the language you write in when Kokoah supports it, otherwise in English. Commands keep working as before, also when the AI is busy or down. Under the switch, **Questions today** shows how many of today’s questions you’ve used (see the [daily limit](https://kokoah.com/docs/telegram-assistant#daily-limit)). ##### Ask about your account Ask in plain words, for example “why did my ETH long close?”, “what did I pay in funding this week?”, “how far am I from liquidation?” or “what happens if BTC drops 10%?”. The assistant answers only from facts Kokoah gathers for the question: - Your account value, free margin and margin used. - Each position: size, entry, mark, PnL, leverage, margin, liquidation price and distance, funding over the last 7 days, stops and take-profits, and its PnL if the price moved 5, 10 or 20% either way. - Open orders, and your order history with its fills: the last 7 days, or the range you ask about, up to 30 days. - Price, 24h change, funding and open interest of the coins involved, recent news on them and the latest market report. - Your alerts, and your notices of the last 2 days. It explains what happened and why, in a few short lines. It doesn’t predict prices or tell you what to do: asked “should I close?”, it lays out the facts and options and leaves the call to you. It remembers the last few messages for 30 minutes, so “and ETH?” continues the question. When an answer is about one position you hold, a button opens that position’s menu. ##### Trade and set alerts in your own words Write what you want, for example “long SOL 200 with a 3% stop”, “close half my BTC”, “move my ETH stop to breakeven” or “tell me every 2% SOL moves”. The assistant understands these trades: - Open or add, with a market order or a limit price (within 50% of the current price). - Reduce or close, by a percent, a dollar amount or a coin amount. - Set a stop-loss or take-profit on a position, or move the stop to breakeven. - Cancel one coin’s orders, or all orders. The coin, the side and the size are never guessed. When one is missing, the assistant asks, one question at a time, with buttons when the answers are few. A new position also gets a question about a stop-loss, with **No stop** only when your limits don’t require one. Sizes can be in dollars, in coins or a share of your free margin. What code fills in by itself, such as a market order or the coin’s current leverage, shows in the preview. Alerts work the same way: price levels, percent moves (within 60 minutes unless you say otherwise), steps of a dollar amount or a percent, funding, position PnL, distance to liquidation and account margin. The assistant shows the alert and asks **Save** or **Cancel**. A saved alert notifies each time its condition starts to hold, in the chat, in the app and as a push. > A finished trade goes to the same [preview, Confirm and PIN](https://kokoah.com/docs/telegram-trading#preview-and-confirm) as commands, so it needs Trade from Telegram on. After 4 questions, the assistant suggests the matching command instead. An unfinished request waits 10 minutes; write “cancel” or press Cancel to drop it. ##### Voice notes Send a voice note of up to 30 seconds instead of typing. The assistant writes down what you said, replies “I heard: …” and handles the words as if you had typed them. - Longer notes are refused before they’re downloaded. Say it shorter, or type it. - A voice note counts as one question. - The audio goes to the AI provider once, to be transcribed, and is never stored. - If this server’s AI model can’t take audio, the bot asks you to type instead. ##### Daily limit The assistant takes a limited number of questions per account and day, 30 by default. **Questions today** under the switch shows your count and this server’s limit. The count resets at 00:00 UTC. - Every question, request or voice note to the assistant counts, including the answers you type to its questions. - Greetings, thanks and goodbyes don’t count, and neither does a message it can’t help with, such as a withdrawal, a request for advice or anything off topic. - Pressing its buttons doesn’t count. - At the limit, the bot tells you when it resets. Commands still work. ##### Privacy: what the AI sees To answer, Kokoah sends the AI provider: - Your message (or your voice note, to transcribe it) and the last few turns of the conversation. - Account numbers and coins: the facts listed above, such as positions, orders, fills, funding, your alerts, the titles of recent notices, news and prices. - Your app language. It never sends your wallet address, your keys or account ids: the facts hold no address or ids, and their times are in UTC. What Kokoah keeps: - The last few turns (up to 6) for 30 minutes so follow-up questions work, and an unfinished request for 10 minutes. Then they expire. - A count of questions and AI usage per day, for the limit and for costs. AI calls are logged without their text. - Never the audio of a voice note. > With **AI in Telegram** off, your chat messages never go to the AI, and trade reviews come without the AI sentence. The weekly review is written by AI either way; turn it off with its own switch. More in [AI principles](https://kokoah.com/docs/ai-principles). ##### Numbers come from code The AI never places a trade or saves an alert. It reads and drafts; code works out every price, size, fee and distance, and every trade goes through the preview, your Confirm and your PIN. Before an answer is sent, every number in it is checked against the facts and your question. If one doesn’t match, the assistant tries once more; if it still doesn’t, you get “I couldn’t answer that reliably” and a command to try instead, such as `/positions`. Greetings, thanks and requests it can’t help with, such as withdrawals, transfers, keys, investment advice or anything off topic, get a short fixed reply written by Kokoah, never by the AI. #### Briefs, reviews and digests https://kokoah.com/docs/telegram-briefs The morning brief, trade and weekly reviews, followed-trader digests and top-trader moves in Telegram. ##### Morning brief One short message each morning, put together by code without AI, in your Kokoah language: - The market: the mood and headline of the latest market report. - Your account value, and its change since the last brief. - Each position (up to 6): size, entry → mark and PnL, liquidation price and distance, and what funding costs or earns a day. - Any position within 3% of its stop. - The last 24 hours: positions closed with their result, and how many alerts fired. - Up to 2 important headlines on your coins. It goes to the chat and your inbox, not as a push. It reaches the chat only while **Alerts in Telegram** is on. ##### Time, days and time zone Turn on **Morning brief** in the Telegram settings. It’s off by default, and the settings offer it once right after you link a chat. - **Time**: Any quarter hour of the day. The default is 08:00. - **Time zone**: Taken from the device you turn the brief on with. On a device in another zone, the card offers a button to use that zone instead. - **Days**: **Every day**, or **Weekdays** (Monday to Friday in your time zone). - **Only when I have positions or orders**: Skips days with nothing to report: no open position or order, no position closed and no alert fired in the last 24 hours. You get at most one brief a day. If Hyperliquid’s data is slow, it can come later within the hour; after that, the day is skipped. Quiet hours don’t hold it, since you chose its time; the hourly cap applies to it as to other notices. ##### Trade reviews When a position closes completely, a review follows about a minute later: size, entry and exit price, how long you held it and what closed it (your take-profit, your stop, a liquidation or a close), then the gross PnL, fees and funding, and the best and worst point while it was open, with how much of the best you kept. With **AI in Telegram** on, one sentence of takeaway is added. It’s written from those numbers only and checked like the assistant’s answers. - **Off**: No trade reviews, and no weekly review either. - **Every trade**: A review for every closed position. - **Only when the PnL is at least…**: Only when the net result, win or loss, is at least the **Minimum PnL**. This is the default, set to $10. Reviews start with positions closed after you linked a chat with reviews on; older trades aren’t reviewed. The same trades are in your [journal](https://kokoah.com/docs/journal). ##### Weekly review On Monday at your brief’s time and in its time zone (also when the brief is off), you get the AI review of the past week: a summary, what worked and what didn’t, with your number of trades and net result. It’s the same review as in the app, see [weekly review](https://kokoah.com/docs/weekly-review). Turn it off with **Weekly review**. It needs Trade reviews set to something other than Off, and AI on this server. ##### Traders you follow Choose how notices about the [traders you follow](https://kokoah.com/docs/top-traders) arrive with **Traders I follow**: - **Instant**: Each trade as it happens. This is the default. - **Hourly digest**: One message an hour listing what they did. - **Daily digest**: One message a day at your brief’s time. With a digest, the single notices still land in your inbox but don’t go out as a push or to Telegram. A digest lists up to 12 moves (the rest are in the app) and is skipped when nothing happened. > Digests need a linked chat. If you unlink while a digest is chosen, followed-trader notices stay in your inbox only until you link again and pick Instant. ##### Top-trader moves **Top-trader moves on my coins** (on by default) tells you when the top traders turn on a coin you care about: their long share of position value moved by 10 points or more within about an hour. Top traders are Hyperliquid’s most active accounts by 30-day volume. Your coins are the ones you traded in the last 7 days, your favorites and the coins you have alerts on. Only moves with real money behind them count: the top traders hold at least $250,000 in the coin, and their longs or shorts changed by at least $100,000. The message gives both amounts, so you can tell longs closing from shorts opening. Each move is told once: one message per coin and direction in 6 hours, and a turn the other way no sooner than 2 hours after. It’s information only: nothing is copied. ##### Turn them off Each has its own switch or choice under **Assistant** in the Telegram settings, and changes save automatically. All of them need a linked chat, so unlinking stops them. Trade reviews, the weekly review, digests and top-trader moves go to your inbox, as a push and to the chat. The morning brief goes to the inbox and the chat only. To keep one in the inbox but off your devices, check it under **Don’t push these events** in the [Notifications settings](https://kokoah.com/docs/notifications). That stops both push and Telegram for it. ### AI The trade assistant, the rule builder and how Kokoah uses AI. #### The AI trade assistant https://kokoah.com/docs/ai-assistant Describe a trade to Kokoah’s assistant in your own words: it fills the order ticket, and you check and confirm it. ##### Describe a trade Open Kokoah’s assistant: the round Kokoah button in the bottom-right corner, or **Ask Kokoah** in the trade page’s market header. Then describe the trade in the chat. The same chat answers questions about markets and about Kokoah: see [Kokoah assistant](https://kokoah.com/docs/help-assistant). 1. Write the trade the way you would say it, for example “long ETH $2k, stop 3% below”. 2. Press **Send** (or Enter). 3. When the draft is complete, the order ticket of that market fills in and its confirm window opens with every detail: size, value, leverage, margin, liquidation price, fees, take profit and stop loss. 4. Check it and confirm to send the order, or cancel to keep editing it in the ticket. Nothing is sent until you confirm. > The assistant only drafts. It never places orders, moves funds or approves anything. ##### What it understands - Opening or adding to a position: market, limit, stop and take-profit orders, and reduce-only orders. - A size in coins or in dollars, a limit or trigger price, and a stop loss and take profit as a price or a percentage. - Closing all or part of an open position, for example “close 50% of my SOL”. The close is reduce-only. Leverage you name (a whole number up to the market’s maximum) is set on that market when you confirm, just before the order. Orders for sub-accounts or vaults can’t be loaded into the ticket. It refuses withdrawals, transfers, deposits, approvals and questions about keys or wallets, and it doesn’t give advice or predictions. Text that looks like a private key is refused before it reaches the AI. ##### Understood, assumptions and questions - **What I understood**: The details the assistant read from your text, in its reply in the chat. - **Assumptions to check**: What it assumed or adjusted, such as the price used to turn dollars into coins or a price rounded to the market’s precision. - **Needs your answer**: What is missing or unclear: the assistant asks in the chat. Answer it there; it keeps what you said before. If only the size is missing, the ticket still fills in with everything else and asks you to type the size. A number you didn’t write becomes a question instead of a guess. Kokoah’s code does every conversion: dollars into coins at your limit price or the current mid price, rounded down to the market’s size step; a stop or take-profit percentage into a price; prices to the market’s precision. ##### Check the draft in the ticket While a draft is loaded, the ticket shows **AI-assisted draft** with your words and the assumptions. Sizes and prices were computed by Kokoah code, not by the AI. Nothing is sent until you confirm. The order goes through the normal review, pre-trade checks, your limits and signing, and the confirm step says **Drafted by AI**. **Dismiss** keeps the fields but stops marking the order as AI-assisted. The draft clears once an order from it is accepted. More on the ticket in [the order ticket](https://kokoah.com/docs/order-ticket) and [pre-trade checks](https://kokoah.com/docs/pre-trade-checks). ##### Explain this risk In the order ticket, open **Details** and press **Explain this risk**. Kokoah first writes an explanation from its own numbers: the margin the order uses, the estimated loss at the stop (or that there is no stop) and each warning. When AI is on, a plain-language version replaces it, but only if every number in it matches Kokoah’s numbers. Otherwise, or when AI is off, you keep the explanation written by code. It explains; it never tells you what to do. ##### Availability and limits You need to be signed in, and AI must be turned on for Kokoah’s server; otherwise the dialog says so and you use the ticket directly. Describing a trade isn’t available where trading isn’t allowed (see [eligibility](https://kokoah.com/docs/eligibility)). - Up to 50 AI requests per account in any 24 hours, across the web app’s AI features. - Up to 10 drafts and 30 risk explanations a minute, and 150 AI requests a day from one network. - A daily spending cap per account and for the whole server. When one is reached, AI pauses and everything else keeps working. - A request can be up to 1,000 characters long. See [how Kokoah uses AI](https://kokoah.com/docs/ai-principles) for what the assistant sees and keeps. #### The AI rule builder https://kokoah.com/docs/ai-rule-builder Describe a guardian in plain words, review the rule Kokoah builds from it, then create it. ##### Where to find it Open **Alerts** → **Guardians**, expand **Custom rule** and find **Describe a guardian**, marked **AI-assisted**. Guardians are rules that Kokoah’s servers carry out for you, even when the app is closed. Read [guardians](https://kokoah.com/docs/guardians) first if they are new to you. ##### Describe the rule 1. Write the rule in **Your rule**, for example “if BTC closes above 70k on the 4h, buy 0.01 BTC with a stop at 67.5k”. 2. Press **Draft the rule**. 3. Read **What I understood**, **Assumptions to check** and **Needs your answer**. Add any missing detail to your text and draft again. 4. A complete draft opens the **New guardian** editor with its fields filled in. While questions remain, you can still press **Review and edit** under the proposed rule to finish it in the editor. Order sizes are in coins: if you give dollars, it asks for the size in coins. A number you didn’t write becomes a question for you to confirm. ##### What it can build Every guardian type: - **Protect partial fills**: A stop loss (and an optional take profit) for the filled part of a resting limit entry, resized as it fills. - **Move stop to breakeven**: When the price or your profit reaches a level, moves the stop to your entry price. - **Take-profit ladder**: Closes parts of a position at several prices. - **Trailing stop**: A stop that follows the best price by a fixed distance and never loosens. - **Time exit**: Closes or reduces a position at a time or after a duration. - **One-cancels-other entries**: Two entries; when one fills, the other is canceled, with an optional bracket. - **If this, then that**: Up to 5 conditions (price, candle close, funding, time window), then an order, a close, a reduce, or just an alert. - **Liquidation guard**: Alerts, reduces or adds margin as a position nears liquidation. - **Daily loss lock**: After a realized loss, opening or adding to positions through Kokoah is blocked for the rest of the day. Closing and reducing still work. It doesn’t build price or account alerts: use the [New alert](https://kokoah.com/docs/price-alerts#create) form, or ask the [Telegram assistant](https://kokoah.com/docs/telegram-assistant) in plain words. ##### Review, create and turn on The draft opens in the same editor as any guardian, marked **Drafted by the AI assistant**. **What this guardian will do** is written by Kokoah from the rule itself, not by the AI. Change any field, then press **Create guardian**. Nothing is created before that, and the rule keeps an **AI-assisted** badge in your list. A guardian acts only once guardians are turned on (**Turn on guardians**) with an [automation key](https://kokoah.com/docs/automation-key) and your signed limits, and it always stays inside those limits. > A guardian can place and close orders for you. Check every price, size and condition before you create it. ##### Limits and privacy The rule builder sends only your text to the AI. It refuses withdrawals, transfers and anything that isn’t a trading rule, and it gives no advice or predictions. It shares the daily AI limits of the [trade assistant](https://kokoah.com/docs/ai-assistant#availability) and needs AI turned on for Kokoah’s server. When AI isn’t available, build the rule with the form instead: every guardian type is there. #### Kokoah assistant https://kokoah.com/docs/help-assistant Ask what’s moving a market, how anything in Kokoah works or about your own account; describe a trade, or a change to your orders, stops or alerts, and it prepares it for you to confirm. ##### Open it Select the round Kokoah button in the bottom-right corner of the app, or **Ask Kokoah** in the trade page’s market header. A small chat opens (a full screen on phones); the expand button in its header makes it full screen on a computer too. Type a question in any language. New chat starts over; the chat is kept only in this browser tab. You can drag the round button anywhere on the window; it stays there in this browser. ##### What it knows The assistant reads these docs, the guides, the common questions and the glossary, the same text as this site, kept up to date. For every question it searches all of it and reads the sections that fit, then answers from them and lists them under the answer so you can read more. When it doesn’t find the answer there, it says so and points you to the closest page or to Contact support. It doesn’t guess how a feature works. ##### Questions about your account Ask about your own positions, orders, fills, PnL, funding or alerts (“Why was my order canceled?”, “Explain my open positions”), and it reads that account: the one you’re using in the app, a sub-account included. It sees only your own account, the same data the app shows you, and never anyone else’s. An answer that used your account says so. ##### Questions about markets Ask what is happening in a market: “Why is BTC dumping right now?”, “What’s moving crypto today?”. The assistant reads Kokoah’s live data for the markets you name, or the one on screen: the price moves of the last day with their times, the order flow from Kokoah’s own Hyperliquid node (what buyers and sellers did, positions opened and closed, liquidations), funding, open interest and positioning, and how the largest markets moved. It also reads the news Kokoah tracks: what regulators, exchanges and the crypto press published in the last day, prediction-market odds and the latest market news edition with the stock, rate and commodity moves it saw. It ties a headline to a move only when its time fits, says so when no news explains a move, and lists the headlines it used under the answer. It explains what happened and what the data shows; it never predicts prices or tells you what to trade. ##### Describe a trade Write a trade the way you would say it, for example “long ETH $2k, stop 3% below”, and the assistant fills the order ticket of that market and opens its confirm window. The order is sent only when you confirm there; the assistant never places it on its own. More in [the AI trade assistant](https://kokoah.com/docs/ai-assistant). ##### Change your orders, stops and alerts Ask for a change to what you already have: “cancel my SOL orders”, “remove my BTC stop”, “move my ETH stop to breakeven”, “take profit at 120k on my BTC”, “alert me if ETH drops 5% in an hour”. The assistant finds the orders or the position in your account (on Hyperliquid’s main perpetual markets) and works out every price itself: a percent is from the current price, breakeven is your entry price, and each price goes on the market’s tick. It checks each price before you see it: a stop loss beyond the price by at least the market’s stop buffer (0.1% on BTC, up to 0.5% on thin markets) and short of your liquidation price, a take profit by the same distance on the winning side. A confirm window then shows what will change, checked again against your account at that moment, and nothing is sent until you confirm. A new stop loss or take profit covers the whole position and goes on before the one it replaces is canceled. An alert is saved as the alert form would save it: a price level tells you once, other alerts each time they start to hold. For a rule that acts later or again and again, such as “trail my BTC stop by 2%” or “move my stop to breakeven once ETH reaches 3,500”, it drafts a guardian and opens it in the guardian editor, where you check it and save it. More in [Guardians](https://kokoah.com/docs/guardians). ##### Screenshots Add up to 3 images to a question with the image button, or paste or drop them into the chat: a screenshot of what you see is often the quickest way to ask. Large images are made smaller first. Numbers the assistant reads from a screenshot can’t be checked, and the answer says so. ##### What it won’t do - **Act**: It never places, changes or cancels anything on its own: every trade or change it prepares waits for you in the confirm window, and a guardian in its editor. It never moves funds or changes settings. - **Advise**: No predictions and no buy, sell or hold suggestions. - **Share what isn’t public**: Nothing about the people behind Kokoah or any person, other users, or how Kokoah is run inside: it only helps you use Kokoah. - **Take secrets**: Never share a seed phrase, private key or password. A question carrying a key is stopped before it is sent anywhere. As everywhere in Kokoah, [numbers come from code](https://kokoah.com/docs/ai-principles#numbers-from-code): every number in an answer must appear in the docs it read, the market data and news, your account or your question, otherwise it is asked again once and then says it isn’t sure. ##### Privacy and limits Your question, the last few turns, the docs sections it picked, your account data for account questions and trades, the market data and news for market questions, and any screenshots go to the AI provider to write the answer. Kokoah keeps none of them: only that a question was asked and its size, for the daily limits. You need to be signed in, and each question counts toward your daily AI limit. #### AI reads https://kokoah.com/docs/ai-reads Plain-language reads of a trader, a market and the market scanner, written by AI from public data with every number checked. ##### Where to find them - **A trader’s page**: **AI read of this trader**, under the overview: how they trade, what works for them, the risks, and what they hold now. - **The positioning panel**: **AI read** of the market, under the reading line: what stands out in its positioning and what to watch. - **The market scanner**: **AI summary of the markets**, above the table: the markets that stand out and why. - **A bot test**: **AI read of this test**, under a [bot’s test on past prices](https://kokoah.com/docs/bots#backtest): what drove the result and what to keep in mind. It is written from that test’s settings and numbers, kept for the same test only, and like the others never says to start, stop or change a bot. ##### What a trader’s read uses Kokoah’s services gather the trader’s public data and work out the numbers in code: their place on Hyperliquid’s leaderboard (profit, return and volume per period, drawdown, active days), their newest 2,000 fills as closed trades (win rate, average win and loss, how long winners and losers were held, sides, sizes and markets), their open positions with how the best traders, the crowd and the whales lean in each market, and their large moves of the last 7 days. The AI only puts that into words. ##### What a market’s read uses A market’s read uses the same data as the [market scanner](https://kokoah.com/docs/market-scanner#columns) and the positioning panel: how the crowd, the best traders and the whales lean now, a day ago and a week ago, open interest, the liquidations within 2% and 5% of the price, the day’s largest whale trades and the TWAPs filling now, along with how the groups lean across all markets. The scanner’s summary uses one line of that per market for the 15 largest and the 15 others that stand out most. Amounts are written short, like $33.5M. A market’s read gives both sides: the bull case (what in the data supports a rise) and the bear case (what supports a fall), then which way the data leans: bullish, bearish or balanced. The lean is a reading of the positioning right now, not a forecast. Kokoah keeps each lean and checks the price 4 hours, 24 hours and 7 days later. Under the read you see how often past reads leaned the right way over the last 30 days, for that market once it has enough reads and for all markets before that, next to how often the price rose after any read. One read an hour per market counts. ##### How it is checked As everywhere in Kokoah, [the numbers come from code](https://kokoah.com/docs/ai-principles#numbers-from-code): every number in the answer must appear in the data sent, copied or rounded. An answer with any other number is asked again once, then refused, and you see an error instead of a wrong number. > A read describes public data. It makes no predictions and never says to buy, sell, copy or avoid anything. It is not financial advice. ##### Shared reads and limits The data is public, so one fresh read serves everyone who asks in the same language: a trader’s for an hour, a market’s for 15 minutes, the scanner’s for 30 minutes. The refresh button writes a new one when the read shown is more than a few minutes old. Reads need you to be signed in, run only when you ask, and count toward your daily AI limit only when a new one is written. #### How Kokoah uses AI https://kokoah.com/docs/ai-principles Numbers from code, drafts you confirm, what the AI sees and keeps, and what happens when AI is off. ##### Where AI appears - A trade described to **Kokoah’s assistant**, which fills the order ticket: [the trade assistant](https://kokoah.com/docs/ai-assistant). - **Explain this risk** in the order ticket. - **Describe a guardian** under Guardians: [the rule builder](https://kokoah.com/docs/ai-rule-builder). - The [weekly review](https://kokoah.com/docs/weekly-review) of your closed trades on Portfolio → Performance. - The [Telegram assistant](https://kokoah.com/docs/telegram-assistant) with **AI in Telegram** on (off until you turn it on): questions about your account, trades and alerts in plain words, and one sentence in each trade review. - The [Kokoah assistant](https://kokoah.com/docs/help-assistant) (the round button in the corner): questions about Kokoah and your own account. - [AI reads](https://kokoah.com/docs/ai-reads) of a trader, a market and the market scanner, from public data, when you ask. In the app, AI drafts and reviews are labelled **AI-assisted**. Everything else, including pre-trade checks, the morning brief, step alerts, the “Why:” line on price alerts and help near liquidation, is built by code without AI. ##### Numbers come from code, never from AI Kokoah’s code computes every price, size, PnL, fee and distance. The AI may only repeat numbers that you wrote or that Kokoah gave it, rounded at most. Every answer is checked before you see it. An explanation, review or Telegram answer with a number that doesn’t check out is rewritten once; if it still fails, it isn’t shown, and you keep Kokoah’s own explanation or get a plain message instead. In a draft, a number you didn’t write becomes a question for you. Conversions, such as dollars into coins or a percentage into a price, are always done by code. ##### The AI never acts The AI reads, explains and drafts. On its own it never places or cancels orders, moves funds, approves anything or turns on a guardian. Every draft goes through a step you confirm: the order ticket and its confirm, the assistant’s confirm window (orders to cancel, a stop loss or take profit, an alert), the guardian editor, or the Telegram preview with Confirm (and your PIN when you set one). Your signed limits apply as always. Requests about withdrawals, transfers, deposits, approvals, keys or seed phrases are refused. The AI gives information, not advice: no predictions and no telling you to buy or sell. ##### What the AI provider sees Requests go from Kokoah’s servers to the AI provider Kokoah uses; your browser never talks to it. Each feature sends only what it needs: - **A trade you describe**: Your text, the selected market and its current price, and your open positions (market, side, size). - **Describe a guardian**: Only your text. - **Explain this risk**: The order’s market, side, type, leverage and margin mode, and the risk numbers Kokoah computed. - **Weekly review**: The week’s closed trades and statistics, and your own journal notes and tags. A week without closed trades sends nothing. - **Telegram assistant**: Your message and the account facts it needs: your account figures, positions, orders, fills, funding, alerts, recent notices and news. > Kokoah doesn’t send your wallet address, keys or other people’s data to the AI. Text that looks like a private key is refused and never sent. Kokoah will never ask for your keys. ##### What Kokoah keeps - In the web app, a record of each AI request (your text, the draft and its size in tokens) for up to 180 days, to enforce the limits and check how the AI behaves. Text that looks like a private key is never stored. - Your weekly review, so it opens again without a new request. - In Telegram, not the text of your questions and answers: only a daily count and token totals. The last few turns are kept for up to 30 minutes so follow-up questions work. Voice notes are never stored. More in the [privacy policy](https://kokoah.com/legal/privacy). ##### Limits, and when AI is off AI is optional. It works only when Kokoah’s operator turns it on for the server, and the whole app works without it: you trade with the ticket, build guardians with the form and still get the risk explanation written by code. Daily limits keep the cost in check: see [availability and limits](https://kokoah.com/docs/ai-assistant#availability) for the web app. The Telegram assistant has its own cap of 30 questions a UTC day. When the AI is down or over a limit, the feature says so and nothing else changes: Explain this risk keeps the code explanation, Telegram commands keep working, and your alerts, guardians and orders carry on as before. ### Automation Guardians, bots, copy trading and the automation key. #### Guardians https://kokoah.com/docs/guardians Protective rules that run on Kokoah’s servers: every rule type, templates, pausing, the activity log and limits. ##### How guardians work A guardian is a rule that watches a position or the market and acts for you: it moves a stop, takes profit, closes, reduces, cancels or alerts you. Guardians run on Kokoah’s servers, so they keep working when this app is closed. Open **Alerts → Guardians**. You need a signed-in account, and automation must be on for the Kokoah server you use; otherwise the page says Guardians aren’t available right now. Guardians trade through a separate [automation key](https://kokoah.com/docs/automation-key), only inside limits your main wallet signs. Kokoah’s guardian engine checks rules in cycles, every 5 seconds by default, so a guardian acts at its next check, never instantly. When a market’s data is stale, rules on that market wait instead of acting on old prices. The Guardian engine card shows Connected, Degraded (some checks are delayed), Down (guardians aren’t being checked) or Disabled, and when the last check ran. > Stops resting on Hyperliquid keep working even when Kokoah’s servers are down; guardians don’t. For protection that matters most, also keep a [stop-loss on the exchange](https://kokoah.com/docs/tp-sl). ##### Turn on guardians The first time, press **Turn on guardians**. Your wallet asks twice: 1. Approve the automation key: a readable approval for a key named kokoah-bot. 2. Sign the guardian limits: close and reduce only. With these default limits, guardians can close, reduce and cancel, but can’t open or add to positions. Rules that open positions, such as one-cancels-other entries or an order placed by “If this, then that”, need wider [automation limits](https://kokoah.com/docs/limits#automation-limits). > Your account must hold funds on Hyperliquid before it can approve a key. Guardians for a sub-account need signed limits that include it; Turn on guardians asks you to sign again when they don’t. ##### Protect a position The quickest way to add a guardian: press **Protect** next to a position in **Protect a position**, or choose **Protect…** in the position’s menu. Pick a template and adjust one number: - **Trail**: A stop that follows the best price at the distance you set (3% to start) and never loosens. It rests on Hyperliquid and ends when the position closes. - **Close at a loss**: Closes the whole position at market when the price reaches the level where your loss equals the amount you enter in USD. - **Take half**: Closes half the position when the price is the percentage you set beyond your entry (10% to start). These templates only close or reduce, so the default guardian limits cover them. ##### Guardian types There are nine types. The daily loss lock watches the whole account; the others act on one market. - **Protect partial fills**: Watches a resting limit entry. As it fills, places a stop-loss (and an optional take-profit) for the filled size and resizes it with each fill. Stops when the entry is fully filled or canceled. - **Move stop to breakeven**: When the mark price reaches a level, or the profit reaches a multiple of your initial risk (R), moves the stop to your entry price, optionally plus or minus an offset in bps. An existing stop moves only if the new one is tighter. - **Take-profit ladder**: Closes parts of the position at up to 10 prices. Each level closes a share of the size the rule first saw, at most 100% in total. A flipped position completes the rule. - **Trailing stop**: Keeps a stop a fixed distance (a percentage or USD) behind the best mark price, optionally only once an activation price is reached. It moves the stop only when it improves by at least the minimum step (10 bps by default), never loosens it, and can take over a stop you already have. - **Time exit**: Closes the position, or reduces it by a percentage, with a market order at a set time or a number of minutes after you create the rule. - **One-cancels-other entries**: Places two entry orders; when one fills, cancels the other. It can add a take-profit and a stop-loss for the filled size. It opens a position, so it needs wider automation limits. - **If this, then that**: Up to 5 conditions, and all or any of them must hold: a price crossing a level (mark, mid or oracle), a candle closing above or below a price, the hourly funding rate above or below a value, or a time window. Then it places an order (with an optional take-profit and stop-loss), closes, reduces by a percentage, or only alerts you. It fires once, or again after a waiting time you set. - **Liquidation guard**: Watches the distance from the mark price to your liquidation price. In stages you choose, it alerts you, reduces the position by a percentage, or adds isolated margin a step at a time up to a total (isolated positions only). Each stage re-arms once the distance recovers. - **Daily loss lock**: Once today’s realized loss passes an amount in USD or a share of your equity, opening or adding to positions through Kokoah is blocked until the daily reset (00:00 UTC unless you change it): from the order ticket, guardians, bots and Telegram. Closing and reducing still work. > The daily loss lock covers what Kokoah sends. Orders placed elsewhere, such as in Hyperliquid’s own app, aren’t blocked. To also cap losses in what your automation key may sign, set Max daily loss in your [automation limits](https://kokoah.com/docs/limits#automation-limits). ##### Create and edit a rule Open **Custom rule**. Start from a template (Stop to breakeven at 1R, Two-step take profit, Trailing stop 3%, Liquidation guard, Daily loss lock) or press **New guardian** and pick any type. You can also describe a rule in your own words with the [AI rule builder](https://kokoah.com/docs/ai-rule-builder) and review its draft before saving. While you fill in the form, What this guardian will do explains the rule in plain words, with estimated fees (taker rate plus the Kokoah fee), the stops already open on Hyperliquid, and what happens if the price gaps through a level: the guardian acts at its next check and the order fills at the next available price. - Market orders a rule sends allow up to 100 bps (1%) slippage unless you set another value, from 1 to 1,000 bps, under Expiry and slippage. - An optional expiry stops the rule at a set time. - A rule that has already acted can’t be edited: duplicate it and change the copy. > You can save a rule before guardians are on, but it won’t act until the automation key is approved and your limits are signed for it. ##### Status, pausing and activity - **Armed**: Watching; it acts when its condition is met. - **Triggered**: It has acted and is still working, for example a trailing stop that keeps moving or a daily loss lock that is locked. - **Completed**: Done: it finished its job, or its position closed. - **Paused**: Not watching: paused by you, by Pause all automation, or because the automation key or your limits need attention. The reason shows under the rule. - **Failed or Expired**: It stopped after an error (the reason shows under the rule), or its expiry time passed. Each rule has Pause or Resume, and a menu with Edit, Duplicate and Delete. Deleting stops the rule; orders it already placed stay on the exchange. **Pause all automation** in the Guardian engine card stops every guardian at once, and bots and Telegram trades too: the automation key signs nothing until you press **Resume automation**. Nothing is canceled on the exchange, and new guardians start paused meanwhile. The Activity tab lists every check that led to an action, every order and every failure, newest first: Checked, Triggered, Order sent, Blocked by your limits, Exchange error, Paused and Failed. You also get a notice when a guardian acts, fails or is paused. ##### Limits and safety - Up to 50 active rules (armed, triggered or paused), counting your sub-accounts and the algos Kokoah’s servers run for you together. - Every guardian order goes through Kokoah’s signer servers, which check it against your signed automation limits and add the Kokoah fee. An order outside your limits is refused and shows in Activity as Blocked by your limits. - Creating, editing and resuming guardians needs an eligible region. Pausing, deleting and revoking always work. - The page shows the rules of the account you picked. A sub-account’s rules trade only for it and watch only its own positions and losses. - A step-by-step guide: [Guardians](https://kokoah.com/learn/guardians). #### Bots and algos https://kokoah.com/docs/bots Grid, DCA, indicator and TradingView signal bots, and the algo orders Kokoah runs for you: settings, limits and stopping. ##### How bots work Bots live in **Bots**, a Pro place (on a phone, open it from the account menu). A bot runs on Kokoah’s servers through your [automation key](https://kokoah.com/docs/automation-key), so it keeps trading when this app is closed. Every order is checked against the limits your main wallet signed and carries the Kokoah fee. Press **New bot** and pick a kind: Grid, DCA, Indicator signals or TradingView signals. [Copy trading](https://kokoah.com/docs/copy-trading) starts from a trader’s page. Nothing runs until you start it, and you can stop any bot at any time. Alerts, bots, guardians, followed traders and automation need at least $10 in your Hyperliquid account (perps and spot together). Charts, market data, scans and AI reads are free for everyone. What you set up keeps running if your balance drops later; turning something back on needs the $10 again. - Bots trade Hyperliquid’s main perpetual markets only: no spot and no HIP-3 markets. - One bot per market and account. A bot trades for the account you picked: your main account or a sub-account. - Up to 10 active bots in all. - Kokoah’s servers work through running bots in cycles, every 5 seconds by default, and send at most 10 new bot orders a minute for you. A bot waits instead of acting when market data is stale or your account couldn’t be read. ##### Grid bot A grid places limit orders on price lines between a lower and an upper price. At the start, buys rest on the lines below the price and sells on the lines above. When an order fills, the bot answers it one line away: a filled buy gets a sell one line higher, a filled sell a buy one line lower. Each answered pair is one completed grid. - **Lower price and Upper price**: The range. The upper price can be at most 10 times the lower price. - **Levels**: Price lines, 2 to 100, including both ends. Each grid must be at least 0.1% wide. - **Spacing**: Equal $ (the same price step) or Equal % (the same percentage step). - **Direction**: Neutral starts flat. Long first buys the size of every sell above the price, so the sells close it; Short does the opposite. - **Amount per grid**: The value of each order at the lower price, at least $10. Every order has the same size in coins. - **Leverage cap**: The grid won’t start if it could take the account above this leverage. - **Stop conditions**: A stop-loss price and a take-profit price outside the range, and Stop when the price leaves the range. When the grid stops, its resting orders are canceled and its position is closed or kept, as you choose. The form shows the profit per grid after fees, the fees per grid (maker fee and Kokoah fee on both orders) and the value of all orders. Grids profit when the price moves back and forth inside the range and lose when it leaves it. If some grids lose money after fees, use fewer levels or a wider range. Orders more than 45% from the price wait until the price comes closer. ##### DCA bot A DCA bot buys (or sells) a fixed amount at market on a schedule. Buys build a long; sells build a short. - **Amount per order**: At least $10. - **Interval**: Every 15 minutes, hour, 4 hours, 12 hours, day or week. - **Number of orders**: Empty: until you stop it. After the last order the bot finishes and keeps the position. - **Leverage cap**: Orders that would take the account above it are skipped. - **Take-profit**: Closes the whole position with a reduce-only market order once the price is this percentage beyond the average entry (below it for sells). The next order starts a new cycle. - **Safety orders**: Resting orders on dips (on rallies for sells), each one step further from the cycle’s first price and the size multiplier times the previous one, up to 25 orders and your safety cap per cycle. A paused or late bot never catches up with a burst of orders: the next order comes one interval after the late one. ##### Test a bot on past prices Before you start a grid or DCA bot, **Test on past prices** in the form shows what it would have done with the same settings over the last 7, 30 or 90 days. The test runs the bot’s real rules (the same ones Kokoah’s servers run) over Hyperliquid’s past prices in your browser. Nothing is traded. 1. Fill in the bot’s settings. 2. Pick the period and the account value to test with (your account’s value when known). The test’s account holds only this bot. 3. Select **Run test**. - **Result**: What the bot made or lost after fees and funding: closed trades plus the open position at the end, and that as a percent of the account value. - **Grids completed**: Grid bots: each time a fill was answered one line away and that order filled too (bought low and sold higher, or the other way round). - **Largest drop from a peak**: The most the result fell from its best point during the test, also as a percent of the account value. - **Largest position**: The biggest the bot’s position got, and that as a multiple of the account value (its leverage). The chart shows the price with the grid’s range and the fills (up to 200), and the bot’s result below it. A banner says when the bot stopped early: at its stop-loss or take-profit, when the price left the range, when a grid couldn’t start under the leverage cap, or when the account was liquidated. How it’s simulated: 5-minute candles for 7 days, 15-minute for 30 days and 1-hour for 90 days. A resting order counts as filled only when the price traded through it, not when it just touched it. Inside a candle the price is taken to move once down and once up, so a grid’s quick back-and-forth inside one candle isn’t counted. Market orders pay 0.03% slippage; fees use Hyperliquid’s base rates plus Kokoah’s fee, and funding is paid or received every hour. The account is liquidated when its value falls to the maintenance margin. Select **Explain this result** for an [AI read](https://kokoah.com/docs/ai-reads) of the test: what drove the result and what to keep in mind, written from the test’s numbers with every number checked. Past prices don’t predict future ones, and neither the test nor the read is financial advice. ##### TradingView signal bot A signal bot turns alerts into orders through a private webhook. Paste the alert message the form shows into your TradingView alert. When the bot starts you see its webhook URL once: save it and add it to the alert. If it leaks, make a new one with New webhook URL on the bot’s page; the old one stops working. - **Order size**: Used when an alert gives no size. - **Cap per order and Position cap**: Each order is capped, and the bot’s position stays within the position cap. - **Direction**: Both, Long only (sells only reduce) or Short only (buys only reduce). - **Require an HMAC signature**: For your own scripts: each alert must carry an X-Kokoah-Signature made with the bot’s secret. TradingView can’t sign, so leave it off for TradingView. - An alert says buy (or long), sell (or short), or close (or flat) to close the bot’s position. An alert with a limit price becomes a limit order; otherwise it’s a market order. - Each alert id trades once. A repeated id is logged as a duplicate, even when the first one was refused. - Alerts sent while the bot is paused, more than 30 a minute, or older than 2 minutes when their turn comes are not acted on. - Every alert is logged in the bot’s Alerts tab, with the reason when it isn’t executed. ##### Indicator signal bot An indicator bot watches the chart’s indicators for you. At every close of its candles (5 minutes to 1 day), Kokoah’s servers read its rules, also while this app is closed, and act when one comes true: it alerts you, trades, or both. No TradingView account or webhook is needed. - **Rules**: Up to 4. Each one is Buy, Sell or Close, with up to 5 conditions that must all be true, or any of them. - **Conditions**: An indicator or the price compared with a number or another indicator: crosses above, crosses below, is above or is below. Supertrend and Parabolic SAR can also turn up or down. - **Indicators**: Price, RSI, EMA, SMA, MACD, Bollinger Bands, Keltner and Donchian Channels, Stochastic, Stoch RSI, CCI, Williams %R, MFI, ADX / DMI, ATR, VWAP, Supertrend, Parabolic SAR and Ichimoku, with the lengths you choose. They are computed exactly as the chart draws them. - **Alert me**: A notification in the app, and by push or Telegram as your notification settings say. The bot never trades, so it needs no automation key or limits, and another bot may trade the same market. - **Trade, or Both**: Each Buy or Sell is a market order of the order size, inside the caps, the leverage cap and the direction, as for a TradingView signal bot; Close closes the bot’s own position. Both also sends the alert. - A rule acts at the close where its conditions become true, and again only after they stopped being true. “RSI below 30” alerts once when RSI drops below 30, not at every close while it stays there. - When rules fire at the same close, Close goes first, then one buy or one sell. A buy and a sell together cancel out. - A close is read within about a minute. One that can’t be read within a tenth of its candle (2.5 to 10 minutes) is skipped, and the bot’s log says so. - Start from a ready-made strategy (RSI, an EMA cross, MACD, Bollinger Bands, Supertrend and more), change it as you like, and test it on past prices before you start: the test reads the rules at each close with the server’s own code and trades at the next candle’s open. - Every close where a rule fired is listed in the bot’s Signals tab, with what the bot did. ##### Limits and starting a bot The form shows the automation limits all your bots need together: the largest order, the daily volume of every bot (including what was already placed today), the markets and the leverage cap. - When your signed limits already cover the bot, Start bot starts it. - Otherwise press Review limits. Kokoah shows the one set of limits to sign: your current limits with only the short ones raised. Then press Sign limits and start. The first time, your wallet also approves the automation key, so it asks twice. Bots open positions without an attached stop-loss and manage their own exits. If your limits require a stop-loss on new entries, the new limits keep that rule for guardians and Telegram trades and let only bot entries skip it. Bot market orders allow up to 1% slippage. More on each field: [automation limits](https://kokoah.com/docs/limits#automation-limits). Kokoah’s signer refuses a bot’s entries while the coin’s leverage on Hyperliquid is set above your automation limit, and Hyperliquid starts every coin at about 20×. So bots may lower a coin’s leverage to your limit before their first order on it; they never raise it. Starting or resuming a grid, DCA or signal bot also sets its coin’s leverage first, with this device’s trading key, and the form says so before you press the button. Limits signed before bots could do this need signing again: the Bots page asks. ##### Pause, stop and follow a bot Your bots are listed with their status, PnL, runtime and resting orders. Open one to see Overview, Orders, Log and, for signal and indicator bots, their Alerts or Signals. A bot’s PnL counts only its own fills, not your other trades. - **Pause**: No new orders. Resting orders stay, and their fills still count for the bot. - **Resume**: Needs signed limits that still cover all your active bots, as when you start one. - **Stop…**: Choose what happens to its resting orders (Cancel them or Leave them) and its position (Close it or Keep it). Closing uses reduce-only market orders and never touches your other trades. Left orders can still fill later; the stopped bot won’t answer them. - **Delete**: Removes a stopped or failed bot from the list. **Pause all automation** on the Guardians page keeps every bot from placing orders. When the automation key expires or is revoked, or your limits aren’t signed, a bot pauses and you get a notice; fix the key or limits, then resume it. ##### Algo orders In Pro, the order ticket’s **More order types** offers five algos that Kokoah runs itself (never Hyperliquid’s own TWAP). Follow them in the **Algos** tab under your positions, which shows where each one runs and offers Pause, Resume and Stop. - **Scale**: 2 to 50 limit orders between a start and an end price, each its own order: the same size, more near the start, more near the end, or your own percentages. An optional stop can stay on Kokoah’s servers, sized to what fills. - **Chase**: A post-only order one tick inside the best price, moved as the price runs away until it fills (at most every 2 seconds, up to a limit you can set). It runs in this tab. If the tab closes, the last order stays on the book, or, if you chose so, Kokoah cancels it or keeps chasing from its servers after 90 quiet seconds. At most 5 chases at once. - **TWAP**: Slices an order over 5 minutes to 7 days, at least 30 seconds apart, optionally with random size and timing (±20%) and a price limit that pauses it. Reduce-only TWAPs that close or reduce your position run on Kokoah’s servers when guardians are on; the others run in this tab, so keep it open. - **Trailing stop**: A stop on your position that follows the best price and never loosens. It rests on Hyperliquid, and Kokoah’s servers move it. - **Bracket**: An entry with its stop-loss and up to three take-profits, each closing part of the size. It can move the stop to breakeven after the first take-profit, or add a second entry where the first to fill cancels the other. The orders rest on Hyperliquid; Kokoah’s servers place the take-profits as the entry fills. > Algo work done on Kokoah’s servers uses your automation key, so the first time your wallet asks twice to turn on guardians. Algos that run in the tab sign with this device’s trading key and need the tab open. #### Copy trading https://kokoah.com/docs/copy-trading Mirror a top trader’s position changes into your account, with your own size, caps and loss limits. ##### How copy trading works Copy trading is a kind of bot. Open a trader’s page in **Discover → Top traders** (Pro) and press **Copy**. Set your size and limits, accept the risks and press **Start copying**. The copy then runs on Kokoah’s servers through your [automation key](https://kokoah.com/docs/automation-key), even when this app is closed. Kokoah reads the trader’s positions at most every 30 seconds (less often when many traders are watched), not from a live feed. Each change it sees becomes orders in your account: - The trader opens or adds: your copy opens or adds, sized as you chose. - The trader reduces: your copy shrinks by the same fraction, with reduce-only orders. - The trader closes or flips: your copy closes; after a flip, the new side is opened like a new position. Only changes after you start are copied, not the trader’s open positions. The dialog shows how late a change typically reaches your account; it fills at a different price than the trader’s. ##### Who you can copy - Only traders on Hyperliquid’s leaderboard. - Not vaults: vault deposits happen on Hyperliquid. - Not your own address. - Not in regions where copy trading can be regulated: there the dialog says it’s not available. See [regional eligibility](https://kokoah.com/docs/eligibility). The trader doesn’t know you copy them, has no duty to you and isn’t paid by you or by Kokoah. ##### Size and caps - **Share of their size**: Copies a percentage of each change in the trader’s position size, from 0.01% to 1,000%. - **Fixed amount**: Each open or add is copied with the amount you set in Per open or add (at least $10). Reduces and closes follow the trader proportionally. - **Cap per order**: The most one copied order can be worth. - **Total cap**: The most all copied positions together can be worth. It is also the budget losses are measured against. - **Leverage cap**: Copies never take your account above this leverage. A change that ends up below Hyperliquid’s $10 minimum after the caps is skipped, and the bot’s log says so. ##### Markets and loss limits Open Markets and loss limits in the Copy dialog: - **Only these markets**: Copy only these, for example “BTC, ETH”. Empty: all. - **Never these markets**: Markets that are never copied. - **Stop at a drawdown of**: Stops the copy when its value (the total cap plus the copy’s PnL) falls this percentage below its best value. - **Stop at a daily loss of**: Stops the copy when it loses this much in a UTC day, realized and unrealized. - **When a loss limit stops the copy**: Close its positions or keep them. HIP-3 markets, and markets another of your bots trades in the same account, are never copied. ##### Risks - Past results don’t predict future results. You can lose money, including all of the copy’s budget. - Copies are not instant and fill at other prices than the trader’s. - Small changes, blocked markets and orders above your caps are skipped, so your results differ from the trader’s. - Copied orders pay the usual fees, including the Kokoah fee. Before you can start, tick “I understand these risks and want to copy this trader.” ##### Test a copy on past trades Before you start, **Test on past trades** in the copy form shows what copying the trader with your settings would have done over the last 7 or 30 days. It follows the trader’s real trades with the copy’s own rules: only changes after the start, your size, your caps per order and in total, the leverage cap, the markets you allow, and your drawdown and daily loss stops. Nothing is traded. - **Trades copied**: The trader’s position changes the copy acted on, and those it skipped: most often because a cap was reached, or the copied size would be under Hyperliquid’s $10 minimum. - **The trader’s result**: What the trader realized in the same period, in their own size. Their dollars aren’t yours: compare whether both gained or lost, not the amounts. - **By market**: The copy’s result in each market, largest first. How it’s simulated: the trader’s positions as Kokoah reads them every poll (positions held at the start aren’t copied, and a quick in-and-out between two reads isn’t either, as live); copy orders at the trader’s latest price 0.1% worse, with the taker fee and Kokoah’s fee; funding at the rates the trader paid or received; the account holds only the copy and is liquidated at the maintenance margin. The trades come from Kokoah’s record of every trade on Hyperliquid: a period before it started, or a trader who trades so often that the whole period can’t be read, makes the test shorter, and the result says so. Select **Explain this result** for an [AI read](https://kokoah.com/docs/ai-reads) of the test, with every number checked. Past trades don’t predict future ones, and neither the test nor the read is financial advice. ##### Limits, pausing and stopping Like every bot, a copy needs automation limits that cover it. The dialog shows what it needs and asks you to sign new limits when yours are too tight: see [limits and starting a bot](https://kokoah.com/docs/bots#limits-and-start). Manage copies on the Bots page. Pause stops copying. When you resume, the copy starts again from the trader’s current positions: changes made while it was paused are not copied late. Stop… cancels or leaves its orders and closes or keeps its positions. #### The automation key https://kokoah.com/docs/automation-key The limited key Kokoah’s servers use for guardians, bots and Telegram trades: what it can do, your signed limits, renewing and revoking. ##### What it is The automation key is a separate trading key named kokoah-bot. Kokoah’s signer servers create it and keep it encrypted; it never exists on your device. Your main wallet approves it on Hyperliquid with one readable signature. Everything Kokoah does for you while the app is closed uses it: [guardians](https://kokoah.com/docs/guardians), algos that run on Kokoah’s servers, [bots](https://kokoah.com/docs/bots), copy trading and [trades you confirm in Telegram](https://kokoah.com/docs/telegram-trading). It takes one of the three [named key slots](https://kokoah.com/docs/api-wallets#key-slots) Hyperliquid gives each account, and it is listed as Kokoah automation among your trading keys. Before your wallet is asked to approve the key, the app checks that Kokoah’s signer servers made it for you: they sign every key they create, and the app checks that signature against a key built into this version of Kokoah, for your address, this network and a one-time code the app just picked. If the check fails, nothing is signed. ##### What it can and can’t do It can: - place, modify and cancel orders; - add isolated margin, when a liquidation guard asks for it; - do this only within the limits you sign, for your main account and the sub-accounts those limits name. It can never: - withdraw or transfer funds: that is refused for every Kokoah key, whatever limits you sign; - approve anything or change your account; - act after it expires or after you revoke it. > A key that can trade can still lose money by trading. That is why every automated order is checked against limits that only your main wallet can sign. ##### Set it up The quickest way is **Turn on guardians** in **Alerts → Guardians**, or the first start of a bot or a server-run algo: your wallet approves the key, then signs limits. To choose the key’s lifetime yourself, open **Automation key and limits (advanced)** on the Guardians page: 1. Pick Valid for: 1, 3, 7, 14 or 30 days (7 by default). 2. Press Create automation key. Kokoah shows its name, address and expiry. 3. Press Approve in wallet. Your wallet shows a readable approveAgent request for that name, address and expiry, and Kokoah posts it to Hyperliquid. 4. If Hyperliquid doesn’t show the key yet, press Check again after a moment. 5. Sign your automation limits (step 2 on the same page). > Your account must hold funds on Hyperliquid for the approval to be accepted, and your wallet may ask to switch network first. When three named keys are already in use, revoke one first. Setting up the key needs an eligible region and your main wallet: a linked phone can’t do it. ##### The limits you sign The automation key only signs orders inside limits your main wallet signs as readable typed data (EIP-712). Kokoah’s signer servers check your signature and every limit before each order, and add the Kokoah fee. Before you sign, Kokoah lists every field, and your wallet shows each of them too: the markets and actions, who may use the key (guardians, bots, Telegram), the sub-accounts, the daily loss limit, the stop-loss rules and spot. Turn on guardians signs close-and-reduce-only limits: new entries are capped at $1, below Hyperliquid’s $10 minimum, so nothing can be opened. Bots, guardian entries and Telegram trades need wider limits, which their screens offer to sign. Signed limits belong to the current key and end when it expires; each new signature stores a new version. Every field and its default: [automation limits](https://kokoah.com/docs/limits#automation-limits). When Kokoah builds on your stored limits, to add a sub-account in one click or to keep bot and Telegram permissions while you change other limits, the app first checks that your main wallet signed exactly those limits. If it can’t, it refuses and nothing is signed. ##### Expiry and renewal The key expires at the end of the period you chose. Kokoah sends an Automation key expiring notice when fewer than 7 days are left. After it expires, guardians, bots and Telegram trades can’t act: a guardian or bot that tries is paused, and you get a notice. To renew, press Renew key, approve the new key in your wallet, then sign your limits again for it. The current key keeps working until the new one is approved; then Kokoah destroys the old one. ##### Revoke or pause Press **Revoke key** under Automation key and limits to turn automation off. Kokoah destroys the key and pauses every guardian. If the key was approved on Hyperliquid, your wallet then signs a readable revoke for kokoah-bot. Open orders are not canceled. After a revoke, bots pause the next time they try to trade, and Telegram trades stop. To use automation again, turn on guardians again, then resume your rules and bots. To stop automation for a while without revoking, use **Pause all automation** on the Guardians page: the automation key signs nothing until you resume. [Revoke all](https://kokoah.com/docs/trading-keys#revoke) in Settings (account menu) → Security also pauses guardians and destroys the key. > Pausing and revoking always work, even where trading isn’t available. A linked phone can pause, but only your main wallet can revoke the key. ### Discover Markets, top traders, market pulse and the funding board. #### Finding markets https://kokoah.com/docs/markets Search, favorites, presets, categories, HIP-3 venues, and what Market info tells you about a market. ##### Searching for a market Open the market picker with the search in the top bar, the market’s name in the market header, or **Ctrl+K** (**⌘K** on a Mac). Type a ticker, a name or an alias such as “bitcoin”, “S&P” or “gold”. Results are ranked by relevance, and the arrow keys move through them. The tabs under the search narrow the results: **All**, **Favorites**, one tab for each category that has markets (**Crypto**, **Stocks**, **Indices**, **Commodities**, **FX**, **Pre-IPO**, **Rates**, **Other**) and, in Pro, **Spot**. Each result shows the price, the maximum leverage and the venue, for example “Bitcoin · Hyperliquid”. Below the results are **All markets**, the [funding board](https://kokoah.com/docs/funding-board) and, in Pro, **Spot markets**. ##### Quick switch On the **Trade** page, hold the right mouse button for a moment anywhere on the page. A wheel opens with the four markets you opened most recently and **News**. Move onto one and let go to open it, or let go first and click one. Esc, the button in the middle or a click outside closes the wheel. Your recent markets are kept in this browser, signed in or not, until you clear its site data; until there are four, the wheel adds BTC, ETH, SOL and HYPE. The quick switch needs a mouse, and text fields keep the browser’s own right-click menu. ##### Favorites Select the star next to a market (in the picker, in the list or in the market header) to add it to **Favorites**, and select it again to remove it. The Favorites tab then shows only those markets. When you’re signed in, favorites are saved with your settings. ##### All markets **All markets** opens the full list with live prices: **Price**, **24h change**, **24h volume**, **Open interest**, **Funding / 1h**, **Max leverage** and a 24-hour line. Select a column heading to sort by it, and select it again to reverse the order. On narrow screens, open interest and max leverage drop out first, then volume and funding. Search, and filter by **Category** and by **Venue**: Hyperliquid’s validator-operated perps, or one HIP-3 deployer. The list shows 100 markets at a time; **Show more markets** adds the next 100. The presets along the top: - **All**: Every live market. - **Favorites**: The markets you starred. - **Top volume**: The 50 markets with the highest 24h volume. - **Gainers and Losers**: The 50 largest 24h rises, and the 50 largest 24h falls. - **New**: The 10 most recently listed of Hyperliquid’s own perps, and the 3 newest on each HIP-3 venue that traded in the last 24 hours. - **Extreme funding**: Funding at or above 0.01% per hour, either way. - **HIP-3**: Builder-deployed markets: stocks, commodities, FX and more. - **Funding board and Spot**: The [funding board](https://kokoah.com/docs/funding-board), and in Pro the [spot pairs](https://kokoah.com/docs/spot-and-convert#spot-markets). If the live prices stop updating for more than 15 seconds, the list says they may be stale while it reconnects. ##### HIP-3 and riskier markets HIP-3 markets are run by their deployer, not by Hyperliquid’s validators, who still run the order book and margin. The deployer sets the oracle price and can halt the market, which closes every position at the mark price. Neither Hyperliquid nor Kokoah reviews deployers. These markets carry a **HIP-3** badge and a note in the market header. See [HIP-3 in the glossary](https://kokoah.com/help/glossary#hip-3). - **Pre-launch**: A hyperp: a Hyperliquid-only perp for a token that isn’t trading on major exchanges yet, priced from its own recent trading. Low leverage, isolated margin only. - **Pool price**: Priced from on-chain pools such as Uniswap instead of exchange prices. Isolated margin that can’t be removed while the position is open. - **Off-hours**: The underlying market of a HIP-3 stock, index, commodity or FX market is closed. For US stocks that is outside 9:30 to 16:00 New York time on weekdays; for the others it is the weekend break, from Friday 17:00 to Sunday 18:00 New York time. - **New**: Among the newest listings (see the New preset). HIP-3 markets aren’t offered in some regions; there they don’t appear in the lists. See [eligibility](https://kokoah.com/docs/eligibility). ##### The market header and Market info The market header shows the mark price and its 24h change, **Oracle**, **24h volume**, **Open interest** and **Funding / 1h** with the time to the next payment. A status badge warns when a market is **Delisted**, **At open-interest cap** (new positions and increases are blocked; reducing and closing still work) or has **No order book** (market orders can’t fill until the book returns). The **Market info** button opens the details: - **Prices and funding**: mark, oracle and mid price, 24h range, premium, the funding rate now and who pays it, the next payment, predicted rates by venue and the funding cap. - **Positioning**, for Hyperliquid’s own perps (see below). - **Leverage and margin**: the maximum leverage, the margin modes and the margin tiers by position size. - **Orders and precision**: the $10 minimum order, the largest market and limit order, the price tick, the price precision and the size step. - **Your fees here**: your Hyperliquid taker and maker rates, the Kokoah fee and the taker total. See [fees](https://kokoah.com/docs/fees). - **HIP-3 market**, for HIP-3 markets: the deployer, who sets the oracle price, the collateral, the margin and the open-interest cap. ##### Positioning For Hyperliquid’s own perps, **Market info → Positioning** shows how the 150 most active traders lean: the accounts with the most 30-day volume among those holding $10K or more, vaults left out. Every long has a short on the other side, so the whole market is always even. What you see is the lean of active traders, by size and by count. It also shows the 24h change in open interest and whether the market’s recent trades were mostly buys or sells. Kokoah’s services read these accounts in turn, so **Updated** tells you how fresh the numbers are. #### Top traders https://kokoah.com/docs/top-traders Hyperliquid’s leaderboard with quality filters, a trader’s page, and following traders for alerts. ##### The leaderboard **Discover → Top traders** (Pro) ranks Hyperliquid’s public leaderboard. Hyperliquid builds it from accounts with at least 100,000 USDC of account value or 10 million USDC of volume. Kokoah’s services read it about every 10 minutes and leave out Hyperliquid’s own system vaults; other vaults carry a **Vault** badge. Discover is in Pro’s navigation; in Simple, links such as **Find top traders** in Alerts still open it. Choose the **Period** (**24h**, **7d**, **30d** or **All**) and **Rank by** (**PnL**, **ROI**, **Volume**, **Account value**, **Drawdown 30d** or **Active days**). The order button switches between **Highest first** and **Lowest first**, and a column heading sorts by that column. **Search traders** finds a name or an address. The list shows 50 traders a page. Names are the traders’ own Hyperliquid display names, otherwise a short address, unless you gave a trader a label of your own (the tag button next to their name): it shows instead. Kokoah never names traders itself. ##### Quality filters - **Minimum equity**: Any, $10K+, $100K+ or $1M+. The list starts at $10K+. - **Maximum 30-day drawdown**: Any, or under 10%, 25% or 50%. Drawdown is the largest fall from a PnL peak in the last 30 days, as a share of the account value before it. - **Active days in the last 30**: Any, 5+, 10+ or 20+: the days whose PnL moved. Drawdown and active days come from Hyperliquid’s account history. Kokoah works them out for the top 100 of each standard ranking and for followed traders, and refreshes them every 12 hours. So a drawdown or activity filter shows only traders whose stats are known; loosen it to see more. ##### A trader’s page Select a trader, or paste any address into the search box, to open their page at **kokoah.com/trader/0x…** (a link you can share). The **Overview** shows account value, PnL, ROI and volume for **24h**, **7d**, **30d** or **All**, the 30-day drawdown and active days, and the win rate, average holding time and share of longs. The chart shows PnL or account value for the same period. The page’s tabs: **Positions** and **Open orders** on every Hyperliquid market, stops and take-profits included; **Trades**, each long or short from open to close with its entry, exit, holding time and PnL after fees; **Fills**; **Order history** (the latest 2,000 orders); **Funding** (30 days); **Transfers**; and **By coin**, the results and win rate per market. Hyperliquid keeps only an address’s latest 10,000 fills. Kokoah’s own node records every fill on the exchange, so for recent months the history is complete; **Load older history** goes further back. Trades are built from the fills loaded, so the oldest may be marked **Partial history**. **AI read of this trader**, under the overview, sums up in plain words how they trade, what works for them, the risks, and what they hold now next to the best traders. See [AI reads](https://kokoah.com/docs/ai-reads#trader-read). Everything on the page is public on Hyperliquid; **Open in Hyperliquid’s explorer** shows the address there. ##### Following a trader **Follow** sends you an alert when the trader opens, adds to, reduces, closes or flips a position, or gets liquidated. It needs you to be signed in, and it uses Kokoah’s services. You can follow up to 100 traders: any address, on Hyperliquid’s leaderboard or not. The bell next to a trader in the chart’s lists follows them too. - On the trader’s page, **Alert me when …** lets you keep any of **Opens a position**, **Adds to a position**, **Reduces a position**, **Closes a position**, **Flips a position** and **Gets liquidated**; at least one must stay on. - An add or a reduce counts when the size changes by at least 10%, and alerts for it come at most once every 5 minutes per market. Opens, closes, flips and liquidations always alert. - Kokoah’s own Hyperliquid node sees every trade on the exchange, so alerts come within seconds, on every market. While it is unavailable, Kokoah checks followed traders every 30 seconds to 15 minutes instead; **Alerts → Following** shows how often. - **Alerts on** pauses and resumes a follow; **Unfollow** removes it. Alerts land in your inbox, and as a push on devices where you allowed notifications (Kokoah asks at your first follow). **Alerts → Following** lists the traders you follow, how many of your 100 you use, and their recent activity. See [alert delivery](https://kokoah.com/docs/alert-delivery). With Telegram connected, **Traders I follow** can send each move at once (**Instant**) or grouped in an **Hourly digest** or a **Daily digest**. With a digest, single moves go to your inbox only. See [Telegram briefs](https://kokoah.com/docs/telegram-briefs). > Following never trades. **Copy** on a trader’s page is separate: it opens the opt-in copy bot on the Bots page, which mirrors the trader’s changes in your account within your own limits. It is offered for leaderboard traders, never for vaults. See [copy trading](https://kokoah.com/docs/copy-trading). #### Market scanner https://kokoah.com/docs/market-scanner Every tracked market’s positioning in one table, with signals that say why a market stands out. ##### What it shows **Discover → Market scanner** puts every market Kokoah’s node tracks in one table: how the crowd, the leaderboard’s best traders and the whales lean, the liquidations close to the price, and what whales and TWAP orders are doing. It refreshes every minute; the node’s readings are at most 5 minutes old. The line above the table says how the groups lean across all the markets, for example that the best traders lean short in most of them. Their shorts can include hedges (a short held against coins kept elsewhere), so a short lean isn’t always a bet on a fall. Read each market against that picture. Select a row to open the market with its [positioning panel](https://kokoah.com/docs/chart#positioning), where the same data is shown in full for one market. ##### The columns - **Crowd long**: The share of the accounts holding the market that are long, by count. Every long has a short, so by value a market is always even: the count is what leans. - **Best traders long**: The share of the value the leaderboard’s 200 best traders (by all-time profit) hold long. A dash: fewer than 3 of them hold the market. - **Change 24h**: How many points that share moved since about 24 hours ago. - **Whales long**: The same share for positions of $1M or more. - **Liquidations ±2%**: Shorts that would be liquidated if the price rose 2% (↑), and longs if it fell 2% (↓). - **Whale trades 24h**: Orders of $100k or more that changed a position in the last 24 hours: what they bought minus what they sold, and how many. - **TWAPs now**: The TWAP orders filling now: what they bought minus what they sold so far, and how many run. ##### Signals Badges under a market’s name say why it stands out. They describe the data; they are not advice. - **Crowd vs best traders**: At least 60% of the accounts are on one side, at least 8 of the best traders hold the market with under 45% of them on that side, and the best traders’ share of value on it is 50 points or more below the crowd’s. The best traders lean short in most markets, so a smaller gap is the usual picture, not a signal. - **Crowded long or short**: 70% or more of the accounts are on one side, in a market with at least 50 accounts. - **Best traders turning long or short**: Their long share moved 15 points or more in 24 hours. - **Liquidations near**: Within 2% of the price sit liquidations worth at least $500k and at least 5% of one side’s open positions. - **Whales buying or selling**: Whale trades in 24 hours bought (or sold) $1M or more net, and at least twice what went the other way. - **TWAP buying or selling**: The TWAPs filling now bought (or sold) $500k or more net. ##### Filters, sorting and search The chips above the table show **All** markets or those with one kind of signal, with how many each has. A column heading sorts by it; at first the markets with the most signals come first. The search box takes words, numbers and comparisons on the columns, for example: `crowd>70` · `smart<40` · `liq>5m` · `whales buying` ##### AI summary **Summarize the markets** asks the AI which markets stand out and why, from the same rows. Every number in it is checked against the data. See [AI reads](https://kokoah.com/docs/ai-reads#market-read). ##### Which markets Every listed Hyperliquid perp with at least 20 open positions, plus the HIP-3 markets someone opened in the last 7 days and those with [market alerts](https://kokoah.com/docs/market-alerts#what-they-are). The table shows 25 markets a page, the ones with the most signals first. #### Market pulse https://kokoah.com/docs/market-pulse The twice-daily market report, what it contains, where its data comes from, and the news around it. ##### When reports come out and where to find them A new report comes out twice a day, around 00:00 and 12:00 UTC, which is Hyperliquid’s clock (its daily candles close at 00:00 UTC). Each report covers the 20 most traded perps by 24-hour volume, plus BTC, ETH, SOL and HYPE. In Pro, open **Discover → Market pulse**. In Simple, the Trade page shows a **Market pulse** strip with the newest report’s mood and headline: **Read the report** opens it, and **Hide until the next report** hides the strip on this device until the next one. **Show** switches between the **Report** and **Earlier reports** (each past report with its mood and headline). Above and below each report, **Earlier report** and **Later report** name their dates, the picker between them jumps to any report, and the ← and → keys step through them. To be told when a report is out, turn on **Market report (twice a day)** in **Settings** (account menu) → Notifications. **High-impact headlines (at most 3 a day)** tells you about major news as it breaks. Both are off by default. The market news every 6 hours comes to your linked Telegram chat unless you turn it off there. See [notifications](https://kokoah.com/docs/notifications). ##### Numbers from code, words from AI Every number, label and chart in a report is computed in code from Hyperliquid mainnet’s public data, read-only: prices, trends and regimes, flags, funding (with Binance and Bybit for comparison), open interest, breadth and the scorecards. The headline, the summary, the notes under **Since the last report**, **Risks**, **Standing out** and **Scenarios** are written by an AI model from a fact sheet of those figures and the day’s headlines, credited to their sources. A text is published only if every number in it comes from the figures and it gives no trading advice. Otherwise the report shows its numbers only, and says so. In other languages, the same model translates the text and the numbers are checked again; a report whose translation fails the check is shown in English. Headlines and news items always stay in English, as published. > The market report is information only. Nothing in it is investment advice or a signal to trade. Scenarios are conditional and say what would prove them wrong. ##### What a report contains - **Mood**: **Risk-on** when most perps are above their 50-day average and BTC’s averages line up upward; **Risk-off** when most are below it and BTC’s averages line up downward; **Mixed** when breadth and the BTC trend disagree. - **Headline figures**: BTC and ETH with their last 48 hours, **Above 50-day average** (and above 200-day), **Median 24h move**, **Median funding** and **Alts vs BTC, 7 days**. - **Market map**: A tile for each asset, coloured by its 24-hour move and sized by open interest; “!” marks a warning flag. Select a tile to trade that market. - **Movers and Regimes**: The biggest 24-hour moves, and each asset as **Trending up**, **Trending down**, **Volatile**, **Squeeze** or **Ranging**, with dots for how many of its averages line up with the trend (up to 3). - **Since the last report**: Regime, flag and mood changes since the previous report, from the second report on. - **News and catalysts**: The top headlines of the 24 hours before the report, Polymarket’s odds on a few questions with their 24-hour change, and CoinGecko’s trending searches. - **Funding and Open interest**: Yearly funding against Hyperliquid’s default rate, with rates unusual for the last 20 days highlighted, and the 12 largest open-interest changes since the previous report. - **Every asset**: A table with price, a 30-day line, 24h, 7d and 30d moves, regime, funding, open interest and flags. - **How the labels played out**: How often each label was followed by a rise 7 days later over the past year, and, in “The reports’ own record”, for published reports only. A description, not a forecast. ##### Flags Flags point out what stands out for an asset. These count as warnings and put “!” on the market map: **Crowded long**, **Crowded short**, **Possible liquidations**, **Mark far from oracle**, **Thin order book** and **Unusually large move**. The others describe: **20-day high broken** or **20-day low broken**, the same for 55 days, **Volatility expanding**, **Volatility compressed**, **Funding high for 20 days**, **Funding negative and low**, **Funding flipped sign** and **Funding differs from CEXs**. ##### News: market news, headlines, Hyperliquid and Kokoah **Discover → News** opens on **Market news**: every 6 hours (00:12, 06:12, … UTC), what moved crypto prices since the previous edition and why — conflicts and oil, central banks and data, stocks and the dollar, fund flows, regulation, hacks, crypto itself and leverage. An AI model writes it from the numbers on the page and the reports it cites, and every number is checked; it is market news, not investment advice. Each edition has its own page with the reports behind every driver, the numbers, the calendar and the odds; **Earlier edition**, **Later edition**, the picker and the ← and → keys move between editions. It is also posted to Kokoah’s Telegram channel. **Headlines** collects news read every 15 minutes from regulators (**Official**), exchange announcements from Hyperliquid, Binance, Coinbase, OKX, Bybit and Upbit (**Exchange**), the crypto press and general business and world outlets (**Media**): titles, short summaries and links only. Filter by **Source**, or choose **High impact only**. Headlines from the last 14 days stay listed. An AI model rates each new item’s importance, direction, topic and coins, and each rating is checked; general outlets show only what it rated as able to move prices. **Hyperliquid** lists the exchange’s own announcements, which Kokoah’s services check every 5 minutes. **Market changes** keeps the ones that can touch a position: delistings, leverage changes, DEX sunsets and market changes. For 14 days, such an item also shows as a banner on the Trade page of each market it names; **Hide this news** closes it on this device. If it names a market where you hold a position or have open orders, it is marked for you and arrives as an alert. Other announcements land quietly in your inbox. **Kokoah** lists Kokoah’s own announcements, newest first: product updates (**Update**), planned work and outages (**Maintenance**) and notices you shouldn’t miss (**Important**). A long text opens with **Show more**, and **Show more** under the list loads older announcements. A link in an announcement opens the page it names in Kokoah, or a website in a new tab. Announcements usually also arrive in your inbox, by push or Telegram as your notification settings allow, and in Kokoah’s Telegram channel. The newest **Important** announcement from the last 7 days also shows as a banner under the top bar. **Read** opens it in **Discover → News → Kokoah** and closes the banner; **Hide this announcement** (×) closes it without opening it. Either way it stays closed on this device. A market’s Trade page shows one news banner at a time: Hyperliquid news about that market first, then Kokoah’s important announcement, then the day’s newest high-impact headline. #### Funding board https://kokoah.com/docs/funding-board What funding is, how rates are shown, and Hyperliquid’s funding next to Binance and Bybit. ##### What funding is Funding is a payment between longs and shorts that keeps a perp’s price close to the underlying price. On Hyperliquid it is paid every hour: position size × oracle price × the hourly rate. When the rate is positive, longs pay shorts; when it is negative, shorts pay longs. Hyperliquid caps funding at 4% per hour. When its premium is zero, the rate is 0.00125% an hour, about 10.95% a year paid by longs; the market report calls this the default. The market header shows **Funding / 1h** and the time to the next payment. **Market info** adds who pays, the next payment time, the predicted rates and the cap. See [funding in the glossary](https://kokoah.com/help/glossary#funding). ##### Where to find it Open the market picker and choose **Funding board**, or the **Funding board** tab in **All markets**; both work in Simple and Pro. In Pro, **Discover → Funding** shows the same board. Selecting a market opens it on the Trade page with the ticket ready. The **Extreme funding** preset in **All markets** lists markets paying 0.01% per hour or more either way, and the [market report](https://kokoah.com/docs/market-pulse#report-contents) has its own funding chart. ##### Reading the board The board lists Hyperliquid’s validator-operated perps with the predicted rate for the next payment on **Hyperliquid**, **Binance** and **Bybit**, read from Hyperliquid and refreshed every 5 minutes. HIP-3 markets aren’t listed: Hyperliquid publishes no predictions for them. **Rates per** shows every rate per **Hour** or per **Year** (the hourly rate × 8,760; this is the default). Binance and Bybit pay every 4 or 8 hours; their rates are converted to the same hourly basis. - **Spread**: The largest difference, either way, between Binance’s or Bybit’s rate and Hyperliquid’s. - **The line under the market**: Where the spread points: **Long HL · short Bybit** (or Binance) when that venue pays shorts more than Hyperliquid charges longs, **Short HL · long …** for the reverse, **No arbitrage**, or **Hyperliquid only** when neither venue lists the market. - **Net**: What the side that collects Hyperliquid funding would get on the **Size** you enter ($10,000 to start) over an hour or a year if the rate held, after opening and closing once as a taker: Hyperliquid’s taker fee (yours when signed in, otherwise the base rate) plus the Kokoah fee, each way. **fees back in** is how long the funding takes to pay those fees back. Fees on other exchanges aren’t included. - **Open interest**: The market’s open interest in USD. > Predicted rates change every hour, and prices move. The net figure is an estimate on a held rate, not a promise of income. ##### Sorting and searching The board starts sorted by the size of the Hyperliquid rate, either way, largest first. Select a column heading to sort by it, and select it again to reverse the order; on phones the headings don’t sort. **Net** sorts like the size of the Hyperliquid rate, and **Spread** always sorts by size. Search by ticker, name or alias. The board shows 25 markets a page, and you can choose 10, 25 or 50. ##### Funding alerts from the board Signed in, the bell on a row saves an alert for when that market’s funding turns the other way: a positive rate turning negative, or a negative one turning positive. It alerts at most once an hour, in your inbox and as a push on this device if you allow notifications. A ringing bell means the market already has a funding alert. **Manage alerts** opens the Alerts page; see [alert delivery](https://kokoah.com/docs/alert-delivery). ### Security Trading keys, devices, API wallets, limits, the email wallet and eligibility. #### Trading keys https://kokoah.com/docs/trading-keys The key that signs your orders on each device, the signer frame that guards it, expiry, renewal and revoking. ##### What a trading key is Kokoah doesn’t ask your main wallet to sign every order. When you [enable trading](https://kokoah.com/docs/enable-trading), this device gets its own trading key: a Hyperliquid API wallet that your main wallet approves once. It can place, modify and cancel orders and change leverage and margin. It can never withdraw or send funds. The one money move it can make is into HLP, Hyperliquid’s own vault, after you confirm in the signer (at most 10,000 USDC at once and 25,000 in 24 hours), and back out of vaults you hold. Each device has its own key with its own name (kokoah- followed by four letters or digits), so enabling trading on a second device doesn’t cut off the first. All of them are listed under [API wallets](https://kokoah.com/docs/api-wallets). ##### The signer frame The key lives in the signer frame: a small Kokoah page on its own web address, embedded in the app. The browser keeps every other site, including the app itself, from reading the frame’s memory or storage, so the app can only ask it to sign. For each order, the frame: 1. reads prices and market data from Hyperliquid itself, never from the app; 2. checks the order against its [built-in rules and your personal limits](https://kokoah.com/docs/limits#baseline); 3. adds the Kokoah fee, signs the order and sends it to Hyperliquid itself. An order that breaks a rule is refused with the reason. Because the frame talks to Hyperliquid directly, trading keeps working when Kokoah’s own servers are down. The key never appears in any message or log. ##### Where the key is stored In **Settings** (account menu) **→ Security → This device**, choose what protects the key: - **This device**: Encrypted in this browser and unlocked on its own after a reload. The default. - **Passkey**: Encrypted with your passkey. After a reload, your first trade asks for your passkey (device PIN or biometric) once. Choose it on shared devices. Switching needs no wallet signature. Passkeys aren’t available in every browser. If the browser can’t store the key at all, it lasts for this session only and you enable trading again next time. > This device protects the key from other sites, not from someone who copies your browser profile. Passkey protection is stronger. ##### Expiry and renewal A trading key is valid for 30 days. From 7 days before it expires, it shows Expires soon and Kokoah sends a Trading key expiring notice. Press Renew trading key: one wallet signature, and a fresh key takes over for another 30 days. An expired key signs nothing. A linked phone’s key is renewed from your computer, by [linking the phone again](https://kokoah.com/docs/linked-devices#remove-a-phone). ##### Turn off and revoke - **Turn off trading here**: Deletes this device’s key and revokes it on Hyperliquid (1 wallet signature). Open orders stay. - **Revoke, in Trading keys**: Revokes any key on Hyperliquid, for example a lost device’s (1 wallet signature). - **Sign out, with “Also remove the trading key from this device”**: Deletes the key here without a signature. Its approval stays on Hyperliquid until it expires, but nobody holds the key any more. - **Revoke all**: Revoke all Kokoah access deletes this device’s key, revokes every Kokoah key on Hyperliquid, stops guardians and withdraws the Kokoah fee approval. Your wallet asks once per step. Positions and open orders stay. Revoking needs your main wallet, and it always works, even where trading isn’t available. > Lost a device? Sign out everywhere ends its session but leaves its key usable until it is revoked. Revoke its key in Trading keys, or use Revoke all. #### Linked devices https://kokoah.com/docs/linked-devices Trade on your phone without a wallet app: how Link phone works, what a linked phone can do, sessions and removing devices. ##### How linking works Link phone lets you trade on a phone that has no wallet app. The phone makes its own trading key, and your computer’s main wallet approves it. No key, seed phrase or signature is ever in the QR code or on Kokoah’s servers. 1. On your computer, open **Settings** (account menu) **→ Security** and press **Link phone**. 2. Scan the QR code with your phone’s camera. The code works once, for 5 minutes. 3. On the phone, check the account and the computer that asked, and press Link this device. The phone makes its key and shows a 6-digit code. 4. On the computer, compare the codes. Press They match: approve only if they are the same, then approve the phone’s key in your wallet (and the Kokoah fee, if it isn’t approved yet). 5. The phone finishes on its own. Press Start trading. The whole link must finish within 15 minutes, and showing a new code cancels the previous one. Linking needs Kokoah’s servers. ##### What you need - A computer signed in with your main wallet: a regular wallet, not a smart-contract wallet. - Funds on Hyperliquid: it approves trading keys only for accounts that hold funds. - An eligible region. - A free [key slot](https://kokoah.com/docs/api-wallets#key-slots). When all three named slots are in use, pick the key the phone replaces; the device using that key stops trading. The automation key is never offered. If the phone already has a trading key, linking deletes it. ##### What a linked phone can do A linked phone signs orders with its own key, inside the same [built-in rules and personal limits](https://kokoah.com/docs/limits) as any device. It sees everything, trades, sets alerts, adds, pauses and resumes guardians, and changes most settings. It can’t: - withdraw, send funds or approve anything: those need your main wallet; - link other phones or remove other devices; - change your personal limits, set up or revoke the automation key, or sign out everywhere; - start or resume bots, make a new webhook, link Telegram or resume paused automation. It can pause and stop them. - edit or resume guardians another device made. Guardians the phone made stop when you remove it; resume them on the computer to keep them. ##### The matching code The 6-digit code proves that the key your computer approves is the one your phone made. Both devices work it out on their own from a secret in the QR code that never reaches Kokoah’s servers, so nobody in between can fake it. > If the codes differ, press They don’t match: linking is cancelled and nothing is approved. If you didn’t open the code on another phone, someone else may have scanned it. Keep your screen private and start again. ##### Sessions Settings (account menu) → Security → Sessions lists every browser and phone signed in to your account, with Last active, Signed in and Expires. Linked phones carry a Linked phone badge. A session lasts up to 30 days and ends after 7 days without use. A linked phone’s session also ends when its key expires or the phone is removed. Security activity lists every link started, approved or cancelled and every phone linked or removed. **Sign out everywhere** signs out every browser and phone, unlinks Telegram and turns trading from it off, and pauses signal bots with their webhook links off. Copy, grid and DCA bots, guardians and the automation key keep running, and trading keys stay usable on their devices until revoked: for a lost or stolen device, [revoke its key](https://kokoah.com/docs/trading-keys#revoke) or use Revoke all. ##### Remove or renew a phone - On the computer, press Remove next to the phone: its key is revoked on Hyperliquid (1 wallet signature) and the phone signs out. Open orders stay. - On the phone, Unlink signs it out and deletes its key there. The key stays approved on Hyperliquid until it expires or you remove the phone on the computer. - A removed phone whose key is still on Hyperliquid shows Revoke key. - A phone’s key is valid for 30 days. To renew it, link the phone again from your computer. #### API wallets https://kokoah.com/docs/api-wallets Every key allowed to trade for your account on Hyperliquid: the kinds, how Kokoah adds them, how many you can have and revoking. ##### What API wallets are Hyperliquid lets an account approve API wallets, also called agents: keys that can trade for the account but can never withdraw. Kokoah calls them trading keys. Only your main wallet can approve or revoke one. See them all in **Settings** (account menu) **→ Security → Trading keys**, including keys other apps created, with each key’s address and expiry. ##### Kinds of keys - **This device**: The key in this browser’s signer frame. - **Kokoah trading key (another device)**: The key of a linked phone. - **Kokoah automation**: kokoah-bot, the [automation key](https://kokoah.com/docs/automation-key) Kokoah’s servers use for guardians, bots and Telegram trades. - **Hyperliquid app (unnamed)**: Usually the Hyperliquid app’s own session. Revoking it makes that app ask you to enable trading again. - **Named like a Kokoah key, not confirmed**: A key named kokoah-… that isn’t this device’s, a linked phone’s or the automation key. Usually your key in another browser: Kokoah tells keys apart by address, because any app can choose a name. Kokoah warns you about it; if you don’t use Kokoah in another browser, revoke it. - **Other app / unknown**: A key Kokoah didn’t create. Kokoah warns you about it; if you don’t recognize it, revoke it. ##### Adding a key Kokoah adds API wallets only through its own steps, each with one readable approval in your wallet: - [Enable trading](https://kokoah.com/docs/enable-trading) adds this device’s key. - [Link phone](https://kokoah.com/docs/linked-devices) adds a phone’s key. - [Turn on guardians](https://kokoah.com/docs/guardians#turn-on) adds the automation key. You can’t import a key into Kokoah, and Kokoah never asks for one. Hyperliquid approves keys only for accounts that hold funds. ##### How many keys you can have Hyperliquid allows three named keys per account, plus one unnamed key, which Kokoah never uses (Hyperliquid’s own app does). Every Kokoah key is named, and the automation key takes one of the three slots. When all three named slots are taken, Kokoah shows the keys and suggests replacing the oldest Kokoah trading key, never the automation key. Approving a name again replaces the key that held it, and the device using that key stops trading. ##### Revoking a key Press Revoke next to a key. Your wallet signs a readable revoke (1 signature) and the key stops working on Hyperliquid. Open orders stay. Revoking always works, even where trading isn’t available. Revoke from the computer that has your main wallet: a linked phone can’t revoke keys. Permissions lists what else Kokoah may do: the Kokoah fee approval, the automation key and other builders you approved. Each has its own Revoke. After you revoke the Kokoah fee, new orders from Kokoah need a new [fee approval](https://kokoah.com/docs/fees). #### Trading and automation limits https://kokoah.com/docs/limits The rules every order must pass: the signer’s built-in rules, your personal limits and the automation limits you sign. ##### Three layers of limits - **Built-in rules**: Fixed in the signer frame for every device’s trading key. Nobody can loosen them. - **Personal limits**: Your own caps for the orders your devices sign, on top of the built-in rules. Saved with your settings, not signed. - **Automation limits**: Caps for the automation key (guardians, bots, server-run algos and Telegram trades), signed by your main wallet and checked by Kokoah’s signer servers. Bots and guardians add caps of their own, such as a bot’s leverage cap or a daily loss lock: see [bots](https://kokoah.com/docs/bots) and [guardians](https://kokoah.com/docs/guardians#rule-types). ##### Built-in rules The signer frame checks every order from a device’s key against these rules: - Trading actions only. Withdrawals, transfers and approvals are always refused. - The Kokoah fee on every order. - Price band: orders that fill right away must be within 5% of Hyperliquid’s mark price; resting limit orders and untriggered stop or take-profit orders within 50%. - Leverage up to 50x, and never above each market’s own maximum. - 60 orders a minute per key; take-profit and stop-loss legs count, cancels don’t. - $250,000 per order and $25,000,000 per UTC day per key, across your accounts. Reduce-only orders don’t count toward these. - Your own account and your sub-accounts only, never vaults. - Each signature is valid for 15 seconds. - Orders worth more than $25,000 in all, take profit and stop loss included, wait until you press and hold Confirm in the signer window. Nothing is sent if you cancel. ##### Personal limits Set them in **Settings** (account menu) **→ Limits**. Leave a field empty for no personal limit. - **Maximum order USD**: The largest order value, up to $250,000. - **Maximum daily USD**: Order value per UTC day, up to $25,000,000. - **Maximum leverage (whole number)**: 1 to 50; each market’s own maximum still applies. - **Require a stop loss for new entries**: Orders that open or add need an attached stop-loss. The signer frame on your device enforces them before anything is signed. They are stored with your settings and applied again each time the frame loads; until then, orders wait with “Applying your trading limits”. Personal limits can only tighten the built-in rules, and a linked phone can’t change them. The signer frame also keeps your limits itself. Stricter limits apply at once; looser ones (a higher amount, a limit removed, spot trading turned on) apply only after you confirm them in the Kokoah signer window, which lists every change. If you don’t, nothing changes: Settings → Limits then shows the limits the signer still enforces, with a button to ask again. Each [sub-account](https://kokoah.com/docs/sub-accounts) can have limits of its own in Settings (account menu) → Sub-accounts; the fields you leave empty use the main account’s. ##### Automation limits On the Guardians page, open **Automation key and limits (advanced) → 2. Automation limits**. Your main wallet signs them; Kokoah’s signer servers check your signature and every limit before each automated order. - **Max order size**: Up to $1,000,000. Default $1,000. - **Max daily volume**: Order value per UTC day, up to $25,000,000 and at least the max order size. Default $5,000. Your main account and sub-accounts count together. - **Max daily loss**: Closed trades minus fees, per UTC day. Once reached, automation only closes and reduces until 00:00 UTC. Empty: no limit. - **Max leverage**: 1 to 50. Default 10. Guardians never change leverage; entries above it are refused. - **Max orders per minute**: 1 to 60. Default 20. - **Limit price band**: How far a limit price may be from the mark price, up to 10%. Default 5%. - **Allowed markets**: Empty: all markets. Or a list such as “BTC, ETH”. - **Stop-loss required on every automated entry**: On by default, with the stop within 25% of the entry price. Bot entries can be exempt, because bots manage their own exits. Reduce-only orders don’t count toward the size caps, so protection always works. The signed limits also name the sub-accounts the key may trade for, the Kokoah fee and who may use them: guardians, bots or Telegram trades. Withdrawing or transferring is never allowed. Max leverage also covers the leverage your account is set to on each coin (Hyperliquid starts every coin at about 20×): Kokoah’s signer refuses automated entries while it is above the limit. Limits that open positions therefore let bots and other automated entries lower a coin’s leverage to your limit before their first order on it; they never raise it. Close-and-reduce-only limits don’t need this. Without it, the bot or guardian pauses until you lower the coin’s leverage on the trade page. > The limits Turn on guardians signs allow close and reduce only: new entries are capped at $1, below Hyperliquid’s $10 minimum. ##### Changing limits - Personal limits save as you edit them in Settings and apply to the signer frame right away. - Automation limits: change the fields, press Review limits, check every field, then press Sign limits in wallet. Each signature stores a new version. - Starting a [bot](https://kokoah.com/docs/bots#limits-and-start) or turning on [Telegram trades](https://kokoah.com/docs/telegram-trading) offers the limits they need: your current limits with only what’s missing added. - Renewing the [automation key](https://kokoah.com/docs/automation-key#renew) needs your limits signed again for the new key. ##### When a limit blocks an order An order from the ticket that breaks a limit is refused before it is signed, with the reason (for example “Your limits block this order.”) and a Review limits button. An automated order that breaks your automation limits is refused too. It shows in the guardians’ Activity as Blocked by your limits, or in the bot’s log. #### The email wallet https://kokoah.com/docs/email-wallet A wallet you create with email, Google or a passkey: what it is, exporting its key, getting it back and staying safe. ##### What it is If you don’t have a crypto wallet, choose **Email, Google or passkey** when you sign in. The first time you log in, a wallet is created for you by Dynamic, a wallet provider. It is a regular Ethereum-style wallet on Arbitrum, and it becomes your main wallet. Like any main wallet, it signs you in, approves trading keys and the Kokoah fee, signs automation limits and approves withdrawals. Dynamic may show its own window to confirm a signature. Your orders are signed by your trading keys, not by this wallet. The option appears only where Kokoah has it set up. You can always choose Connect a wallet and use your own wallet instead. ##### Who holds the key The wallet’s key is kept by Dynamic’s wallet service, not by Kokoah: Kokoah’s code never sees it. The Main wallet card in Settings (account menu) → Security shows Email wallet (email, Google or passkey) when you use it. After a reload, Kokoah reconnects the wallet without a new sign-in. If Dynamic’s own login has ended, it asks you to log in again. Signing out of Kokoah ends that login too. ##### Export the key 1. Open **Settings** (account menu) **→ Security** and find the Main wallet card. 2. Press Export wallet. Dynamic’s secure window opens; Kokoah never sees what it shows. 3. Follow the steps there and keep the key somewhere safe and offline. > Anyone who has this key controls your funds. Never share it, never paste it into a website and never send it to anyone, Kokoah support included. Kokoah never asks for it. ##### Getting your wallet back Your wallet is tied to the login you created it with. On a new device, choose Email, Google or passkey and log in the same way to get the same wallet and address. Kokoah doesn’t hold the key, so it can’t restore access for you. If you could lose access to that email address, Google account or passkey, export the key and keep it safe. You can also import an exported key into another wallet app to use the same address there. ##### Staying safe - Anyone who gets into your email address or Google account may be able to log in to your wallet, so protect them well. - The wallet is only asked for sign-in, approvals, limits and withdrawals. Read each request before you confirm it. - Use only [official Kokoah links](https://kokoah.com/help/official-links), and never enter your email code on another site. #### Regional eligibility https://kokoah.com/docs/eligibility How your region and wallet are checked, what still works when trading is blocked, and features that vary by region. ##### How eligibility is checked Kokoah’s servers decide whether trading is available to you; the app can’t override that. They check: - the country and region you connect from, as reported by Kokoah’s network provider; - whether you connect through a VPN, a proxy or an anonymizing network; - your wallet address, against sanctions lists. The check runs silently: you only see it when it blocks you. Kokoah doesn’t store your IP address. When the result can’t be determined, for example because the country is unknown, trading stays off. The policy is on [Regional availability](https://kokoah.com/legal/regions). ##### When trading isn’t available A red bar at the top of the app says trading isn’t available in your region. The Trade page still shows prices and charts, but its order buttons are off. You can still: - close positions, cancel orders and withdraw, from Portfolio; - pause and delete guardians, pause and stop bots, and revoke the automation key; - revoke Kokoah’s access in Settings (account menu) → Security (see [trading keys](https://kokoah.com/docs/trading-keys#revoke)); - contact [support](https://kokoah.com/support). You can’t enable trading, place new orders, link a phone, create or resume guardians and bots, or trade from Telegram. ##### VPNs and proxies When you sign in, you confirm that you aren’t a restricted person and aren’t using a VPN or proxy to get around restrictions. If Kokoah detects a VPN or proxy, trading is blocked. Resolve it through support; don’t try to bypass it. ##### Wallet screening Kokoah screens your wallet address against sanctions lists when you sign in and before features that trade for you. A result is kept for up to 24 hours; wallets with guardians or bots running are screened again after that. A flagged address stays blocked until a new screening clears it. If a wallet with automation running is flagged, Kokoah pauses all its automation and stops signing for it. While the screening service can’t be reached, trading may stay off. ##### Features that vary by region Some features have their own regional rules, even where trading is available: - [Copy trading](https://kokoah.com/docs/copy-trading) isn’t offered where it can be regulated; the Copy dialog says it’s not available in your region. - Referral incentives and some market categories, such as HIP-3 and outcome markets, can be limited. - [Trades from Telegram](https://kokoah.com/docs/telegram-trading) need a recent check from the app: open Kokoah at least every 72 hours to keep trading there. ### Account & settings Settings, notifications, invites and fees. #### Settings https://kokoah.com/docs/settings The settings window: your account, appearance, trading defaults, the other categories and signing out. ##### Open your settings Choose the gear (**Settings**) beside the light and dark button in the top bar (on a phone, **Account** in the tab bar), or open the account menu (your address in the top bar) and choose **Settings**. Settings open in a window over the page you are on, with the categories in a sidebar; on a phone you pick a category from a list first. Signed out, you can change the appearance and open Help; the other categories need an account. Telegram shows only where Kokoah offers it, and Sub-accounts only when your wallet has some. Every change saves on its own: Kokoah shows “Saving…” and then “Saved”. Settings belong to your account, so they follow you to your other devices. ##### Account Settings → Account shows your wallet address, with a button to copy it, and the network. It also sets the account mode: - **Account mode**: Standard or Unified. A unified account uses one balance for spot and perps, with no transfers between them. This is a Hyperliquid setting for your whole account, and changing it needs one wallet signature. On a linked phone, change the account mode on your computer: it needs your main wallet. ##### Appearance Settings → Appearance sets how Kokoah looks. Language, number format and theme work signed out too. Signed in, all but the number format follow your account; the number format stays on the device you chose it on: - **Language**: Menus, messages and number formats. You can also change it from the account menu. Translated terms are a courtesy; the English versions are binding. - **Number format**: The separators in every number: Automatic follows your language, or choose 1,234.56, 1.234,56, 1234,56 or 1 234,56. Number fields read the same separators: a thousands mark only between groups of three digits, and “.” as a decimal point where it isn’t a thousands mark. A number that could be read two ways is flagged, never guessed. - **Theme**: Light, Dark or System, which follows your device. The theme button in the top bar switches it too. - **Time zone**: Local or UTC, for times in tables, charts and history. - **Hide balances**: Masks amounts until you show them, for screen sharing. The eye button in the top bar does the same. - **Color convention**: Green up or Red up: which color means a rise. ##### Simple or Pro **Settings → Trading → Layout** switches between Simple and Pro. Pro adds the order book and recent trades to the Trade page, spot markets, and the Discover and Bots places. The Layout control in the Trade page’s market header does the same. See [Simple and Pro](https://kokoah.com/docs/what-is-kokoah#simple-and-pro). ##### Trading defaults Settings → Trading sets what the order ticket starts with: - **Default order**: Market or Limit: what a new ticket opens with. - **Size unit**: Enter order sizes in USD or in the coin. - **Slippage**: The most a market order may move from the price you see, in percent. - **Confirm orders**: Always, Only above an amount (then set Confirm orders from), or Only when there’s a warning. A new account starts with market orders, sizes in USD, 1% slippage, a confirmation for every order and the Simple layout. ##### Other categories - **Limits**: Your own caps per order, per day and on leverage, and an optional rule that new entries need a stop loss. See [Limits](https://kokoah.com/docs/limits). - **Sub-accounts**: Shown when your wallet has Hyperliquid sub-accounts. See [Sub-accounts](https://kokoah.com/docs/sub-accounts). - **Notifications**: Quiet hours, the hourly limit, market pulse alerts, muted events and the sound on fills. See [Notifications](https://kokoah.com/docs/notifications). - **Telegram**: The linked chat, alerts and trading from Telegram, the trading PIN and the assistant. See [Telegram setup](https://kokoah.com/docs/telegram-setup). - **Security**: Your main wallet, this device’s trading key, permissions, linked devices and sessions. See [Trading keys](https://kokoah.com/docs/trading-keys), [Linked devices](https://kokoah.com/docs/linked-devices), [API wallets](https://kokoah.com/docs/api-wallets) and [Email wallet](https://kokoah.com/docs/email-wallet). - **Invite**: Your invite link and QR code. See [Invite friends](https://kokoah.com/docs/invite). - **Help**: These docs, the glossary, official links, common questions and service status. ##### Sign out Choose **Sign out** in the account menu or at the end of the Settings sidebar. On a shared computer, tick **Also remove the trading key and this account’s data from this device** first. See [Signing out](https://kokoah.com/docs/sign-in#sign-out). #### Notifications https://kokoah.com/docs/notifications Where notifications reach you, what they cover, desktop notifications, quiet hours and test pushes. ##### Where notifications go - **Inbox**: Every notification lands in Alerts → Inbox, whatever your other settings. Urgent events, such as a liquidation or an order canceled by the exchange, also show as a short notice while Kokoah is open. - **Push**: Notifications on this device, even when Kokoah is closed. Your browser asks for permission the first time you save an alert. - **Telegram**: Messages from the Kokoah bot in a linked Telegram chat, where Kokoah offers Telegram. Link a chat and turn on **Alerts in Telegram** in Settings → Telegram. See [Telegram setup](https://kokoah.com/docs/telegram-setup). - **Desktop**: Pop-ups from your browser while Kokoah is open in a tab and you’re elsewhere, set per device. See [Desktop notifications](https://kokoah.com/docs/notifications#desktop). Kokoah doesn’t send notifications by email. The Alerts page says where your alerts go, for example “Alerts go to your inbox and this device.”, with a link to change it. See [Alert delivery](https://kokoah.com/docs/alert-delivery). ##### Turn on push and test it Kokoah asks for push permission when you save your first alert, never up front. Once you allow it, the Alerts page shows “Push is on for this device” and a **Send a test** button. The test should arrive within a few seconds. If you blocked notifications, Kokoah can’t ask again: allow them for this site in your browser’s settings, then save an alert. On iPhone and iPad, push works only once Kokoah is on your Home Screen: 1. Open Kokoah in Safari. 2. Tap the Share button (the square with an arrow). 3. Choose “Add to Home Screen”, then “Add”. 4. Open Kokoah from the new icon, sign in and save an alert. > Push is set up per browser. Signing out removes this browser’s push subscription, so the next account used here doesn’t get your notifications. ##### Desktop notifications while Kokoah is open In Settings → Notifications → **On this device**, turn on **Desktop notifications while Kokoah is open** and allow notifications when your browser asks. Then, while Kokoah is open in a tab and you are in another tab, another app or another site, new notifications pop up on your computer, like a chat app’s. Click one to go back to Kokoah, on the right page. Choose what pops up on this device: - **Alerts and inbox notices**: What reaches your inbox while you’re signed in, except the events you don’t push, and, unless critical, during quiet hours. - **Market news (every 6 hours)**: Each new edition of the market news. - **High-impact headlines**: Major market news as it breaks. - **Kokoah announcements**: Product updates, important notices and maintenance from the Kokoah team. Market news, headlines and announcements pop up when you’re signed out too. Nothing pops up while you’re looking at Kokoah, and nothing that came before you opened it. With several Kokoah tabs open, each notification shows once, and one that also arrives as a push shows once. When more than 3 come within a minute, the rest are grouped into one “new notifications” summary. While a Kokoah tab is in the background, its title starts with your unread count, for example “(2) Trade · Kokoah”. If your browser blocks notifications from Kokoah, the switch can’t be turned on: open the site settings (the icon at the left of the address bar), set Notifications to Allow, then turn it on. **Send a test** checks that your computer shows them; if nothing appears, check your system’s notification settings for the browser, and Focus or Do Not Disturb. > Desktop notifications need Kokoah open in a tab. Browsers can pause background tabs after a while, and phones pause them as soon as you switch apps, so turn on push for alerts that must reach you. On iPhone and iPad, notifications need Kokoah on your Home Screen. ##### What you’re notified about Besides your own [alerts](https://kokoah.com/docs/price-alerts), Kokoah notifies you about events on your account: - Orders: filled, partially filled, canceled by the exchange, and take profit or stop loss triggered. - Risk: liquidation warnings, liquidations and auto-deleveraging. - Funds: deposits credited and withdrawals completed. - Automation: guardians triggered, failed or paused, bots stopped or paused, and automation problems. - Your account: a trading key about to expire, and Hyperliquid maintenance. - Following and news: traders you follow, Hyperliquid news about your markets, trades from Telegram, and the Telegram assistant’s morning brief and trade reviews. Market pulse is opt-in: turn on **Market report (twice a day)** for a notice around 00:00 and 12:00 UTC, and **High-impact headlines (at most 3 a day)** for major market news as it breaks. **Kokoah announcements** (product updates, important notices and maintenance) reach you like your other notifications unless you turn them off. They are always listed in Discover → News → Kokoah. To stop an event from being pushed, open **More notification settings** and tick it under **Don’t push these events**. Your inbox still records it. ##### Quiet hours and the hourly limit Turn on **Quiet hours** in Settings → Notifications to hold push and Telegram notifications until the window ends; the Telegram morning brief still comes at its time. It starts as 22:00 to 08:00 in your device’s time zone; change the times under Between, and the time zone under More notification settings. **Maximum notifications per hour** (30 unless you change it) caps what is pushed. Over the cap, notifications go only to your inbox. > Critical notifications, such as a liquidation, auto-deleveraging or a trading key that expires within a day, ignore quiet hours and the hourly limit. Muting an event still stops it. **Sound on fills**, also in Settings → Notifications, plays a short tone when an order fills while Kokoah is open. It stays silent during quiet hours and when your device asks for reduced motion. #### Invite friends https://kokoah.com/docs/invite Your invite link and code, how invites are counted, and earnings where rewards are offered. ##### Your invite link Open **Settings** (account menu) → Invite. You get a personal link with your code, a QR code, and buttons to **Copy link**, **Share** (where your device supports it) and **Download QR**. **Copy invite link** in the account menu copies it in one click. ##### How an invite is counted - When a friend opens Kokoah through your link, their browser keeps your code, and their sign-in links their account to you. - An account can be linked to one inviter only, and the first one stays. Later links don’t change it. - You can’t invite yourself, and unknown codes are ignored. Codes aren’t case-sensitive. - Activity in an invited friend’s sub-accounts counts as theirs. ##### Your numbers - **Invited**: Accounts linked to your code. - **Active in 30 days**: Invited accounts that traded in the last 30 days. - **30-day volume**: What they traded in the last 30 days, counted from the moment they were linked to you. ##### Earnings and payouts Where rewards are offered, you earn a share of the Kokoah fees paid by the traders you invited, from their sign-up on. Your invite then also shows **Pending earnings**, **Paid earnings**, a **Payouts** list and the **Program terms**. Earnings are tracked as a ledger. Pending amounts are reviewed before payout and can change if activity is reversed or breaks the program terms. The payout minimum, schedule and holding period appear under Program terms when they are set, and a paid payout links to its transaction. Rewards aren’t offered where local rules restrict incentives, such as the UK and the EU, or when your country can’t be determined. Invites are still counted there. Friends you invite don’t get a separate reward from the invite itself. ##### Sharing rules - Say that you may earn from your invites whenever you share your link. - Never promise returns or profits. - Don’t promote Kokoah to people in restricted regions (such as the US, Ontario, the UK and sanctioned territories), and never suggest a VPN or any other way around a restriction. Full details are in the [Terms](https://kokoah.com/legal/terms) and [regional availability](https://kokoah.com/legal/regions). #### Fees https://kokoah.com/docs/fees Hyperliquid’s trading fee, Kokoah’s builder fee, funding, transfer costs, and where each one shows. ##### Two fees on every fill Each fill pays two separate fees: Hyperliquid’s exchange fee and Kokoah’s builder fee on top. Both are a percentage of the fill’s value (size × price). An order that doesn’t fill costs nothing. The [Fees page](https://kokoah.com/fees) shows Kokoah’s current rate and estimates both fees for an order size, using your own Hyperliquid tier when you’re signed in. ##### Hyperliquid’s fee Hyperliquid charges a taker fee when your order fills right away against the book (a market order, or a limit order that crosses the spread), and a lower maker fee when a resting limit order fills later. At the base tier, perps cost 0.045% as taker and 0.015% as maker. Hyperliquid sets your tier from your 14-day volume. Staking HYPE on Hyperliquid and a Hyperliquid referral code can lower your rates, and spot markets have rates of their own. **Portfolio → Overview → Fee tier** shows your current rates, your progress to the next tier and your discounts. ##### Kokoah’s builder fee Kokoah’s fee is a Hyperliquid builder fee: a percentage of each fill that Hyperliquid adds on top of its own fee and pays to Kokoah. The rate comes from Kokoah’s public configuration and is shown on the [Fees page](https://kokoah.com/fees) and in the order ticket. Your Hyperliquid tier and discounts don’t lower the Kokoah fee. When you enable trading, your main wallet approves the builder fee up to 0.1%. Hyperliquid enforces that ceiling, but it isn’t the rate you pay. See [The builder-fee approval](https://kokoah.com/docs/enable-trading#builder-fee). ##### Funding is not a fee Funding is an hourly payment between longs and shorts that keeps a perpetual’s price near the oracle price. Depending on your side and the rate, you pay it or receive it. It goes between traders, not to Kokoah. When the funding rate is positive, longs pay shorts. Portfolio → Overview shows your funding on its own line, apart from fees. See the [glossary](https://kokoah.com/help/glossary#funding). ##### Deposits, withdrawals and sends - **Deposits**: Kokoah adds no fee of its own. The route may charge one and you pay gas on the source chain; the deposit form shows the fee and what you receive before you sign. See [Deposits](https://kokoah.com/docs/deposits). - **Withdrawals**: The Hyperliquid withdrawal route costs 1 USDC. The Circle CCTP route charges a fee that Kokoah reads from Circle and shows before you sign. See [Withdrawals](https://kokoah.com/docs/withdrawals). - **Sends**: The first transfer to an address never used on Hyperliquid pays a one-time 1 USDC activation fee, which the send form shows. See [Send and receive](https://kokoah.com/docs/send-and-receive). ##### Where you see fees - **Order ticket**: The Fees line estimates the entry fees before you send. The details list the Hyperliquid and Kokoah fees for the entry and for the exit, and the review step repeats them with their rates. - **History**: Portfolio → History → Fills lists each fill with its Hyperliquid fee (Fee) and its Kokoah fee. - **Overview**: Portfolio → Overview adds up Fees paid (Hyperliquid fees, Kokoah fees and the total) for the period you pick. - **Performance**: Portfolio → Performance shows Hyperliquid fees and Kokoah fees for each day. ## Guides ### Your first protected trade https://kokoah.com/learn/first-trade From a blank ticket to a reviewed order, one clear step at a time. #### Choose a market Open Markets and search by ticker or name. Check the market category, margin constraints, funding direction, and price freshness before opening a ticket. Live data freshness is checked before trading. #### Decide your size and leverage Enter a USD notional or coin size. Review how much margin the order needs. Increasing leverage reduces required initial margin but also brings liquidation closer. Risk estimates use shared calculations and live account data. #### Set your protection Add a stop loss and take profit. The ticket shows estimated outcomes and flags a stop beyond estimated liquidation. Attached TP/SL on an entry order activates only after the entry fully fills; a partial fill may be unprotected. #### Read the risk summary Check liquidation distance, estimated loss at the stop, separate fee lines, and funding direction. Execution slippage and gaps can increase losses beyond estimates. #### Review, then confirm The review step repeats the side, market, size, leverage, protection, and fees. Confirming sends the intent to the separate signer frame for policy checks and exchange submission. ### Follow your deposit https://kokoah.com/learn/deposits Understand the chain, the route, and each stage along the way. #### Start with the right network Match the source network and asset to the selected deposit method. Never assume the same address means every chain or asset is supported. Live network availability must come from the route provider. #### Review the amount and route Check minimums, route fees, the expected amount received, and the quote expiry before signing. A route below its minimum must be blocked. Check the selected network before approving any transfer. #### Watch the three stages A deposit moves from submitted on the source chain to in transit, then credited to the account. The transfer page gives each stage a timestamp and explains what remains. #### If it takes longer than expected An unusually long delay is not proof that funds were lost. Keep the transaction hash and route details, avoid sending a second payment to fix the first, and contact support with diagnostics. The support form submits a ticket when account services are configured. ### Stops, margin, and liquidation https://kokoah.com/learn/stops-and-liquidation Three connected ideas that should never be hidden in a tooltip. #### Understand your margin mode Isolated margin assigns collateral to a single position. Cross margin uses eligible account collateral across positions, so other activity can change risk. Market constraints determine whether cross margin is available. #### Read the liquidation estimate Liquidation depends on position size, margin, maintenance tiers, and account state. A pre-trade estimate must be recalculated with verified exchange data before live trading. #### A stop is an instruction, not a guarantee Market stops prioritize execution once triggered and may slip. Limit stops constrain the price but may not fill. A gap can skip the level you had in mind. #### Check protection after every change Adding size, partially closing, or modifying leverage can change your exposure. Recheck stop size and status, and tell an active exchange stop apart from a guardian. ### Know what you’re signing https://kokoah.com/learn/permissions Trading keys, fee approvals, and the controls that stay yours. #### Your main wallet The main wallet is intended to approve permissions, transfers, withdrawals, and account-mode changes. It should not be asked to sign opaque order hashes through this app. #### The device trading key A separate-origin signer holds a limited trading key. The UI shows the key name, address, expiry, and allowed actions before approval. The frontend must never receive the private key. #### The builder-fee approval Approval permits fees up to a disclosed maximum; it is distinct from the current rate. The configured current rate and the 0.1% approval cap are disclosed separately. #### Review and revoke Use the security center to see device and automation permissions. An unexpected key should be reviewed. Revocation is submitted through your main wallet and checked against exchange permissions. ### Withdraw with confidence https://kokoah.com/learn/withdrawals Check your destination, understand the fee, and follow the transfer. #### Use withdrawable balance Equity and withdrawable balance are different. Collateral supporting a position may not be available to withdraw. #### Check the destination Confirm the network, asset, and destination address. A transfer to an exchange address may not be credited if that exchange does not support the route or contract-originated deposits. #### Read the final preview Review the amount, fees, net received, and timing before your main wallet signs. The device trading key cannot withdraw. #### Track, don’t guess The activity page should keep the request and its status visible. If the result is unknown, reconcile the original request before trying again. The transfer tracker retains the original request across reloads. ### Meet your guardians https://kokoah.com/learn/guardians Rules that keep working when you step away. #### A rule with a clear purpose Guardians can move a stop to breakeven, take profit in steps, trail a stop, guard against liquidation and lock trading for the day after a set loss. Each rule has one condition and one action. #### Preview before you arm it Start from a template or build your own rule. The editor shows the trigger, the action and its limits before anything is armed, and a gap through a level can still fill at a worse price. #### Limits and service health Guardians run on Kokoah’s servers with a separate automation key that can only act within the limits you approve. The activity log, the guardian engine’s health and one control to pause them all keep that visible. #### Stops and guardians are different An exchange stop is an order that Hyperliquid holds. A guardian is a rule that places or changes orders when its condition is met, so it depends on Kokoah’s services being up. Use both, and check the status page if something looks late. ## Common questions ### What is Kokoah? Kokoah is a trading workspace for Hyperliquid: perpetual futures, including HIP-3 markets, and spot tokens in Pro. It brings order entry, pre-trade risk, positions and balances, fees, and a trade journal into one place. Public market data comes directly from Hyperliquid. Trading requires a connected wallet, eligibility checks and a separate trading key. ### Can I trade with real money right now? Yes. Kokoah trades on Hyperliquid mainnet with the funds in your own Hyperliquid account, which Kokoah never holds. You need a connected wallet, an eligible region and a trading key on your device. ### Who controls my funds? Kokoah is non-custodial: funds stay in your own Hyperliquid account. A separate trading key can place and manage orders but cannot withdraw or transfer funds. Your main wallet approves a separate key held inside the signer frame. ### What is the difference between a stop and a guardian? An exchange-resident stop is an order held by the exchange. A guardian is a server-side rule that manages your orders when its conditions are met. They have different dependencies, so their status is shown separately. ### How does Kokoah make money? Kokoah charges a per-fill builder fee separately from Hyperliquid’s exchange fee. The Fees page shows the configured rate; the current rate and approval ceiling are disclosed before signing. ### Does the AI make trading decisions? No. Risk values come from deterministic calculations. AI features explain those values or propose a structured ticket for you to review. They do not submit orders or move funds on their own. If the AI service is unavailable, the ticket uses a deterministic local explanation. ### Can I revoke trading access? The security center is designed to let you review, renew, and revoke Kokoah trading permissions. Revoking automation access pauses guardians. Revocation requires your main wallet signature and an exchange confirmation. ### Where will Kokoah be available? Availability requires backend eligibility and wallet screening. The specification excludes the US, Ontario, the UK, and sanctioned territories, and treats detected VPN/proxy connections as restricted. The final policy and country list require review before launch. The backend determines eligibility and screens the signed-in wallet. ### Why does the stop use mark price? The order flow is designed around the exchange’s mark-price triggers, rather than the last traded price. A triggered market stop still faces slippage and price gaps; a stop level is not a guaranteed execution price. ### Do I need to share my seed phrase? Never. Kokoah should never ask for your seed phrase or private key, and support should never DM you first. Do not paste wallet secrets into a support form. ## Glossary - **ADL (auto-deleveraging)**: The exchange closes profitable opposing positions when a liquidation cannot be covered. It is rare, but it can close a winning position without an order from you. - **Builder fee**: Kokoah's per-fill fee, charged on top of Hyperliquid's fee. Your main wallet approves it once, up to a maximum of 0.1%; the current rate is shown separately and can be lower. - **cloid (client order ID)**: An ID attached to every order Kokoah sends, so the outcome of an order can be checked safely even if the connection drops before the exchange answers. - **Cross and isolated margin**: Cross margin shares your balance across positions, so a loss on one position can affect the others. Isolated margin limits a position to the margin assigned to it. Some markets are isolated-only. - **Funding**: Hourly payments between longs and shorts that keep the perpetual price near the oracle price. You pay or receive funding depending on your side and the rate. It is not a Kokoah fee. - **Guardian**: A server-side rule that places, modifies or cancels orders when its conditions are met. Guardians use a separate automation key with limits you approve, and you can pause them at any time. - **HIP-3 market**: A market deployed by a third party (for example trade.xyz stocks and commodities), grouped by its "DEX" and named like xyz:SP500. Fees, collateral and margin rules can differ from core markets. - **Leverage**: The size of a position relative to the margin backing it. Higher leverage moves the liquidation price closer to your entry price. - **Liquidation**: When a position no longer has enough margin, measured with the mark price, the exchange closes it. Kokoah shows an estimated liquidation price before you trade and while the position is open. - **Main wallet**: Your own wallet (external or embedded). It holds your funds and signs approvals and withdrawals. It is never asked to sign individual orders. - **Maintenance and post-only periods**: Hyperliquid schedules upgrades that cause a short downtime, followed by a post-only period in which market orders do not fill. Kokoah shows these notices when they happen. - **Mark price**: The price Hyperliquid uses for margin, liquidation and take-profit/stop-loss triggers. It is a median of several estimates, so it can differ from the last trade. - **Oracle price**: The external reference price reported by validators. It is used for funding payments. - **Post-only (ALO)**: A limit order that only adds liquidity to the order book. It is rejected instead of executing immediately. - **Reduce-only**: An order that can only make a position smaller, never larger or flipped to the other side. - **Signer frame**: A page on a separate, official Kokoah origin that holds the device trading key and signs trading actions after a policy check. The main app never sees the key. - **Take-profit and stop-loss (TP/SL)**: Orders that trigger on the mark price, not the last trade. When attached to a new order they activate only after the entry fills completely. - **Trading key (agent)**: A key approved by your main wallet that can trade but cannot withdraw. Kokoah keeps one per device, inside the signer frame. You can review and revoke it in the security center. - **Unified account**: A Hyperliquid account mode in which one balance backs all of your positions. - **Weekend and off-hours pricing**: Stock and commodity markets trade around the clock, but their underlying markets close. Kokoah marks these periods, when prices can move differently from the underlying market. ## More pages - [Common questions](https://kokoah.com/faq) - [Glossary](https://kokoah.com/help/glossary) - [Official links](https://kokoah.com/help/official-links) - [Fees](https://kokoah.com/fees) - [Service status](https://kokoah.com/status) - [Terms](https://kokoah.com/legal/terms) - [Privacy notice](https://kokoah.com/legal/privacy) - [Risk disclosure](https://kokoah.com/legal/risk) - [Regional availability](https://kokoah.com/legal/regions)