Glossary
Trading Terms
Market Order: Order type that executes immediately at current mark price, prioritizing speed over price precision.
Limit Order: Order type that executes only when market reaches specified price, guaranteeing entry price.
Take Profit (TP): Automated order that closes positions when price reaches favorable level, securing gains. Capped at +2500% PnL.
Stop Loss (SL): Automated order that closes positions when price moves adversely, limiting losses. Capped at -80% PnL.
Collateral: USDT deposited to back a leveraged position. Minimum 10 USDT per position.
Leverage: Multiplier applied to collateral to determine position size. Range: market-specific, up to 1000x for forex.
Position Size: Notional value of position calculated as Collateral × Leverage.
Entry Price: Price at which position opens. Market orders use mark price; limit orders use specified price.
Mark Price: Current oracle-validated market price used for position valuation and liquidation calculations.
Liquidation Price: Price threshold where position automatically closes to prevent negative balance. Calculated based on leverage, fees, and maintenance margin.
Maintenance Margin Requirement (MMR): Minimum collateral required to keep position open, calculated as Size / Max Leverage + Accrued Fees.
Net Rate: Combined hourly funding fee and borrow fee, displayed as annualized percentage. Positive = you receive; negative = you pay.
Funding Fee: Periodic payment between long and short traders based on market imbalance. Net long pays net short, or vice versa.
Borrow Fee: Hourly fee paid by traders to liquidity providers for borrowed capital, based on pool utilization.
Price Impact: Fee based on pool imbalance when opening/closing positions. Deferred model: zero at entry, settles at exit. Capped at 50 bps.
Open Interest (OI): Total notional value of all open positions on each side (long and short separately).
Available Liquidity: Remaining pool capacity available for new positions on each side.
Slippage Tolerance: Maximum acceptable price deviation between expected and execution price for market orders. Default 0.5%, adjustable 0.1%-5%.
Keep Leverage: Toggle for position reduction. Off = reduces size while maintaining collateral (deleverages). On = reduces size and collateral proportionally.
Guaranteed Execution: TP and SL orders execute at requested trigger price regardless of market gaps, protecting traders from slippage during volatility.
Liquidity Provision Terms
HzLP: HertzFlow Liquidity Provider token representing proportional pool ownership. Minted on deposit, burned on withdrawal.
Pool AUM: Assets Under Management—total value of pool including deposited USDT, accrued fees, and net unrealized trader PnL.
HzLP Price: Token value calculated as Pool AUM / Total HzLP Supply. Increases as fees accrue and traders realize losses.
TVL (Total Value Locked): Current pool AUM in USD, representing all liquidity available for trading.
Fee APY: Annualized yield projection from trading fees only (open, close, borrow, liquidation), excluding PnL and funding.
Total APY: Comprehensive yield including all sources: fees, trader PnL, and funding. More volatile than Fee APY.
Max AUM: Protocol-configured ceiling for each pool's total liquidity, preventing over-concentration and maintaining market balance.
PnL Factor: Risk parameter limiting trader unrealized profit as percentage of pool AUM. Three types:
Max PnL Factor for Deposits (strictest)
Max PnL Factor for Withdrawals (looser)
Max PnL Factor for Traders (caps trader exposure)
Reserve Factor: Risk parameter ensuring sufficient liquidity remains for open positions. Calculated as Reserved USD / Pool AUM.
Reserved USD: Total notional value of open positions (OI) on each side requiring pool backing.
Remaining Deposit Cap: Available capacity for new deposits, calculated as Max AUM - Current AUM.
Remaining Withdrawal Cap: Maximum USDT withdrawable, constrained by PnL and reserve factors:
Utilization: Percentage of pool liquidity actively backing open positions. High utilization (>70%) increases borrow fees but constrains withdrawals.
Isolated Pool: Market-specific liquidity with independent risk parameters. Each pool's performance is unaffected by other markets.
Automatic Rebalancing: Contract-level mechanism maintaining 1:1 long-short collateral split regardless of deposit direction or OI imbalance.
Keeper Execution: Automated bot system executing deposits, withdrawals, and position settlements on-chain. Ensures gas efficiency and fast settlement (<10s typically).
Troubleshooting
Common Issues
"Insufficient Liquidity"
Available liquidity for your direction is depleted. Solutions:
Reduce position size to fit available capacity
Wait for liquidity to replenish as positions close
Trade a different market with deeper liquidity
Check Available Liquidity (L/S) in market info before sizing orders
"Above Max Position Size"
Order exceeds maximum allowed position size for this market. Solutions:
Split into multiple smaller positions
Trade a different market with higher limits
Reduce leverage to lower notional size
"Below Min Collateral"
Collateral must be ≥10 USDT. Solutions:
Increase collateral input to meet minimum
Reduce leverage if trying to maintain specific position size
"Above Deposit Limit [Amount]"
Pool at maximum AUM capacity. Solutions:
Wait for pool capacity to increase as traders close positions
Deposit smaller amount within remaining cap
Try a different pool
Check Remaining Deposit Cap in pool info
"Above Withdraw Limit [Amount]"
Withdrawal exceeds available capacity due to PnL or reserve constraints. Solutions:
Withdraw smaller amount within remaining cap
Wait for trader PnL to decrease or positions to close
Check Remaining Withdrawal Cap in pool info
"TP Price Below Mark Price" (Long) / "TP Price Above Mark Price" (Short)
Take profit price not favorable to current market. Solutions:
Long positions: increase TP price above mark price
Short positions: decrease TP price below mark price
Verify you're setting profit target in correct direction
"Above Max TP Price" / "Below Min TP Price"
Take profit exceeds +2500% PnL cap. Solutions:
Click tooltip to auto-fill maximum allowed TP price
Manually adjust TP price to valid range
Consider closing position earlier at lower profit target
"SL Price Above Mark Price" (Long) / "SL Price Below Mark Price" (Short)
Stop loss price not unfavorable to current market. Solutions:
Long positions: decrease SL price below mark price
Short positions: increase SL price above mark price
Verify you're setting stop in correct direction
"Invalid Stop Loss"
Stop loss exceeds -80% PnL cap, often after collateral removal. Solutions:
Add collateral back to expand valid SL range
Edit SL price to valid range within -80% cap
Cancel invalid order if protection no longer needed
"Request Rejected by User"
Wallet confirmation cancelled. Solutions:
Review transaction details carefully
Approve transaction in wallet if parameters acceptable
Check wallet isn't locked or disconnected
"Transaction Failed. Please Try Again Later"
Transaction reverted on-chain. Common causes:
Insufficient gas fees (BNB balance too low)
Price moved beyond slippage tolerance (market orders)
Pool capacity changed between quote and execution
Network congestion causing timeout
Solutions:
Verify ≥0.01 BNB balance for gas
Increase slippage tolerance if market is volatile
Refresh quote and retry
Wait a few minutes if network is congested
"Transaction Pending. Please Check Again Later"
Transaction submitted but not confirmed within 30 seconds. Solutions:
Wait for network confirmation (may take 1-5 minutes during congestion)
Check transaction status on BSCScan using hash from toast
Do not resubmit—this creates duplicate transactions
Contact support if pending beyond 5 minutes
Transaction Shows Success but Balance Unchanged
Interface data may be cached. Solutions:
Refresh the page manually
Wait 10-30 seconds for automatic data refresh
Check wallet directly to verify balance changed
Verify transaction on BSCScan shows success
Getting Help
Contact support@hertzflow.xyz for account issues, bug reports, or other technical problems.
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. You are solely responsible for your trading and investment decisions.
Last updated