> For the complete documentation index, see [llms.txt](https://hertzflow.gitbook.io/hertzflow-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hertzflow.gitbook.io/hertzflow-docs/tutorials/troubleshooting.md). # Troubleshooting Something not working, or a message you don't recognize? Find it below, grouped by where you are in the app. Exact on-screen text (button labels and error messages) is shown in `monospace`; **bold questions** are symptoms you might run into. Each entry explains what's happening and how to fix it. ## Wallet & Network **`Connect wallet to continue`** You aren't connected yet. Click Connect Wallet and approve the connection in your wallet. **`Switch network` / "switch to the correct network and try again"** Your wallet is on the wrong chain. HertzFlow runs on BNB Smart Chain (BSC). Switch your wallet to BSC and retry; the app can prompt the switch for you. **`Approve {token} Spending`** Before your first trade, deposit, or swap with a given token, you grant the contract a one-time spending approval. This is a separate wallet transaction that comes before the action itself. Approve it, then confirm the trade or deposit. **`Insufficient {token} balance`** Your wallet doesn't hold enough of the token for this action. Collateral and deposits use USDT; gas uses BNB. Top up and retry. The input box also caps automatically to your available balance. ## Opening a Trade When the order button is greyed out, it shows the first rule you haven't met. In order: **`Enter an amount`** — no amount entered yet. **`Insufficient USDT balance`** — the order needs more USDT than your wallet holds. **`Approve USDT Spending`** — first-time approval needed (see Wallet & Network above). **`Min Collateral: 10 USDT`** On a new position, collateral after fees must be at least 10 USDT. Increase your input. **`Min Residual Collateral: 10 USDT`** When adding to an existing position, the resulting collateral must still be at least 10 USDT. Add more. **`Min position size: {value}`** Your position size is below the market's minimum notional. Increase your collateral or leverage. **`Above Max Position Size: {value} USD`** Your size is larger than the biggest position allowed right now. The cap is the smallest of three limits: available liquidity on your side, the market's open-interest limit, and the per-account position cap. Reduce size, lower leverage, or wait for capacity to open up. **`Above Max Lev {x}` / `Below Min Lev {x}`** Your leverage is outside the allowed range for this market and mode. Move the slider back into range. (Hyper mode enforces a high minimum leverage; Normal mode enforces a lower maximum.) **`Max leverage exceeded`** The market's open interest is currently high, which temporarily lowers the maximum leverage. The tooltip shows the largest size you can open right now. Lower your leverage or size. **`Above Max Limit Price` / `Below Min Limit Price`** Your limit price is on the wrong side of the mark price for the order to make sense. A long limit order must sit below the mark price; a short limit order above it. Adjust the limit price. **`Invalid liquidation price`** Your inputs would place the liquidation price on the wrong side of the mark price, meaning the position would liquidate immediately. This usually means too little collateral for the chosen size and leverage. Add collateral or reduce leverage. ## Take Profit & Stop Loss **`TP Price Below Mark Price` (long) / `TP Price Above Mark Price` (short)** Your take-profit is on the wrong side of the mark price, so it could never close in profit. Set a long's TP above the mark price and a short's TP below it. **`Above Max TP Price`** Your take-profit implies a gain beyond the maximum profit cap of +2500% PnL (25x your collateral). Click the tooltip to auto-fill the highest allowed TP price. **`SL Price Above Mark Price` (long) / `SL Price Below Mark Price` (short)** Your stop-loss is on the wrong side of the mark price. Set a long's SL below the mark price and a short's SL above it. **`Below Min SL Price`** Your stop-loss implies a loss beyond the -80% PnL cap. This often appears after you remove collateral, which shrinks the valid SL range. Click the tooltip to auto-fill the minimum, add collateral back to widen the range, or move your SL price closer to the mark price. ## Managing & Closing Positions **`High price impact stored - settled upon position decrease.`** This is a notice, not an error, and it doesn't block the order. On large or imbalanced trades the price-impact cost isn't charged when you open; it's stored and settled when you reduce or close the position. Expect it to be deducted at close. **`Unable to Close Position` / `Close Position Failed`** Closing right now would leave too little collateral to cover the current price-impact fee (see the notice above). Add margin to the position, then close it again. **Can't remove margin from a position?** Removing collateral is blocked if it would drop you below `Min Residual Collateral: 10 USDT` or push your liquidation price through the mark price. Remove a smaller amount, or reduce the position size first. **Position closed or shrank on its own?** Two safeguards can do this. Liquidation closes a position once its loss reaches the maintenance threshold. Auto-deleveraging (ADL) trims very profitable positions when the pool's payout cap is reached. Both are normal risk controls, not bugs. **Can't place a limit order or remove margin in Hyper mode?** This is by design. Hyper Leverage is market-order only, charges 0% trading fee, and does not allow withdrawing collateral from an open position. Switch to Normal mode if you need limit orders or margin removal. ## Spot Swap **`Slippage tolerance is too low. Please increase your slippage and try again.`** The price moved beyond your slippage tolerance before the swap could settle. Raise your slippage tolerance and retry. **`Not enough liquidity to complete this trade. Try reducing your trade size.`** The available route can't fill a swap this large. Reduce the amount and try again. **`Failed to fetch a valid swap quote. Please adjust your amount or try again later.`** The swap couldn't be priced right now. Change the amount, or wait a moment and retry. **`Your balance is too low to perform this action. Please add more funds.`** You don't hold enough of the input token. Top it up and retry. **Swap quote keeps refreshing?** Swap quotes expire after about 5 seconds and re-price automatically. Confirm promptly, or click the refresh icon to pull a fresh price. ## Liquidity Pools & Vaults **`Enter an amount`** — no amount entered yet. **`Approve {token} Spending`** — first-time deposit approval (see Wallet & Network above). **`Above Deposit Limit`** The pool or vault has reached its maximum AUM (assets under management). Deposit a smaller amount, wait for capacity to open up, or choose another pool. The amount shown is the remaining capacity. **`Above Withdraw Limit`** Withdrawable capacity is temporarily reduced by open-trader PnL or reserve requirements. Withdraw a smaller amount, or wait for trader PnL to come down. **Withdrawal blocked even though you have a balance?** The pool runs a reserve check that can block withdrawals when open positions are using too much of the pool. You may see "temporarily unavailable: trader PnL exceeds pool limit." Try a smaller amount, or wait for positions to close. **Deposit or withdraw disabled with a PnL warning?** When a pool is deep in trader profit or loss, deposits and withdrawals are paused so the pool is valued fairly. Wait for trader PnL to normalize, then try again. **Pool or vault shows `Paused`?** That market is temporarily paused. All deposit and withdraw actions are disabled until it resumes. **Deposit or withdrawal stuck / not completing?** Deposits and withdrawals are processed in two steps: you submit (your USDT or HzLP is held in escrow), then a Keeper executes it a few seconds later. If a price feed is briefly unavailable or the market is closed, a request can stay pending. After about 30 seconds a stuck request appears in the **Your Pending** tab on the pool/vault page (and as a **Pending Pool Orders** / **Pending Vault Orders** card in the wallet panel). Click **Cancel** (or **Cancel all**) to return your escrowed funds straight to your wallet — no LP is minted or burned. You only pay gas for the cancel. **`Cancelled Deposit` / `Cancelled Withdrawal` in your history?** Your request didn't complete and the escrowed funds were returned to your wallet — nothing was lost. This happens either because you cancelled a stuck request yourself, or because the Keeper's execution check failed (slippage, minimum size, or deposit cap) and it auto-cancelled and refunded you. Cancelled requests don't affect your LP balance, the pool's TVL, or your cost basis. Just re-submit if you still want to deposit or withdraw. **`This order has already been processed. Please refresh the page to check the latest status in history.`** You tapped Cancel just as the request was finally executed or cancelled. Nothing went wrong — refresh the page and check your activity history to see its final state. ## Claiming Rewards You accrue two claimable balances from trading: funding fees (earned while you hold the balance-improving side of a market) and price-impact rebates (refunds of over-charged costs, held briefly for protocol safety). **Price-impact rebate not claimable yet?** You'll see `Claimable in {countdown}`. Price-impact refunds are held for a short safety delay (about 24 hours) before they unlock. Wait for the countdown to reach zero, then use `Claim Price Impact`. **`Claim amount must be greater than 0`** Nothing is claimable yet. Wait until you've actually accrued a funding-fee or price-impact balance. **`Claim failed, please try again`** The claim transaction didn't go through, usually because of low gas or a price refresh mid-transaction. Check your BNB balance and retry. ## Transactions & Wallet Confirmations **`Request Rejected by User`** You dismissed the confirmation in your wallet, so nothing was submitted. Review the details and approve it when you're ready to retry. **`Transaction Failed`** Usually one of three causes: too little BNB for gas, the price moved past your slippage tolerance, or capacity changed mid-transaction. Top up your BNB balance, raise your slippage tolerance, then refresh and retry. **`Transaction failed. Please try again later.`** A generic on-chain failure the app couldn't classify further. Refresh and retry. If it keeps happening, contact support with the transaction hash from your wallet or BSCScan. **`Transaction Pending`** Your transaction was submitted but hasn't confirmed within 30 seconds. During network congestion this can take 1 to 5 minutes. Check its status on BSCScan and wait it out. Do not resubmit: a second transaction only creates a duplicate. **Balance unchanged after a successful transaction?** The interface is probably showing cached data. Refresh the page, or wait 10 to 30 seconds for it to update on its own. If it still looks wrong, confirm your balance on BSCScan. **Why is my gas so high — or why did my order fail?** The **gas price** set in your own **wallet** is too high. * BSC blocks are very fast. **0.05–0.11 gwei is already fast enough** — setting it higher won't make you faster, but it can exceed the default buffer, leave the prepaid Execution Fee short, and cause your order to fail. * If you genuinely need a very high wallet gas price (e.g. sniping new listings), **raise the Network Fee Buffer in the App** to match, so that **(gas price ÷ average − 1) ≤ Buffer** still holds. ## Prices & Availability **`Price Unavailable`** The price feed for this market is temporarily missing or stale, so orders can't execute. Wait for prices to return before submitting an order. **"Temporarily disabled due to security considerations"** Trading is in a protective state. On a market, closing positions and withdrawing funds stay available, but opening or increasing positions is restricted. On a pool, withdrawals stay available, but deposits are restricted. Normal access returns once the safeguard clears. **A market can't be traded / shows as disabled?** The market has been disabled or delisted. You can still close an existing position, but new positions aren't allowed. ## Interface & Rankings **Your rank is missing from the Leaderboard?** The Leaderboard only counts trades inside the selected time window. If your most recent trade falls outside it (for example, more than 7 days ago while the filter is set to 7 days), your rank won't appear. Switch to a longer time window. ## Pre-Deposit (Genesis Vault) **No Merits after a deposit?** A single deposit below 10 USDT earns no Merits and doesn't start its 90-day holding clock. Each deposit must be at least 10 USDT to qualify for Merits and any bonus rewards. **Merits boost disappeared after a withdrawal?** Withdrawing before the 90-day holding period ends removes the Merits boost and any WLFI bonus (USD1 deposits) tied to the withdrawn amount. The app warns you before you confirm, and the action can't be undone. The rest of your balance keeps its original holding timer and is unaffected. ## Getting Help Contact **** for account issues, bug reports, or technical problems. When reporting a failed transaction, include the transaction hash so the team can trace it on-chain. *** {% hint style="danger" %} **Risk Warning:** Trading with leverage and providing liquidity involve substantial risk of loss. Digital asset prices are volatile and can move rapidly against your positions. Liquidity may become restricted during extreme market conditions. Only trade or provide liquidity with capital you can afford to lose. This documentation does not constitute financial advice. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://hertzflow.gitbook.io/hertzflow-docs/tutorials/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.