MyLiquidBot Documentation

Create or prepare your wallet

Use MetaMask, Rabby or a WalletConnect-compatible wallet. This wallet is used to log in or sign approvals; it is never used to share your seed phrase. Never type your seed phrase into MyLiquidBot or any form.

Fund your DEX account

Choose Hyperliquid, Lighter or Aster. Deposit USDC or the required asset on that exchange. If the exchange has no balance, MyLiquidBot can connect but cannot open real positions.

Register and log in to MyLiquidBot

After registration, go to Account → Exchanges. This is where you add API connections for each DEX.

Create API keys without withdrawals

On your exchange, create API keys or an API wallet with read/trading permissions only. Never enable withdrawals. Copy each value exactly where MyLiquidBot asks for it.

Test the connection

After saving the connection, press the test button. If it fails, remove extra spaces, check that you did not paste the wrong wallet, and try again. If you previously had problems adding keys, create the connection again from scratch because several save and verification flows were fixed.

Approve platform fees

To trade, you must approve MyLiquidBot fees: Builder Fees on Hyperliquid or Integrator Fees on Lighter. You sign this with your wallet. It is not a withdrawal permission; it is how the exchange attributes your orders to the platform and allows a low operation fee.

Load Portfolio and create a small bot

When your balance appears in Portfolio, create your first bot with small capital and low leverage. Check that orders appear in MyLiquidBot and also on the exchange.

Link Telegram and explore Copytrading

Telegram alerts you about fills, errors and important events. In Leaderboard / Copytrading you can copy community bot configurations as a starting point, but always adapt size and risk to your own account.

Open registration

Click Create account. Use an email you can access because sensitive routes may require email verification before trading features are available.

Set identity and password

Enter name, email and a strong password. Use a unique password because this account controls trading connections.

Verify email

Open the verification email and confirm the account. If the link expires, request a new verification email from the app.

Configure profile basics

Go to Account and set preferred exchange, quote asset, timezone, language and UI density. These defaults reduce mistakes when creating bots.

Go to app.hyperliquid.xyz and connect your main wallet

Open app.hyperliquid.xyz in your browser. Click Connect wallet and connect MetaMask, Rabby, or another EVM wallet. This is your main wallet — the one that holds your funds.

Go to Settings → API wallets

Once connected, click the menu in the top-right corner and open Settings. Look for the API wallets (or "API" / "Sub-accounts") tab. This is where Hyperliquid lets you create dedicated trading keys.

Generate a new API wallet

Click Generate API wallet (or "Create new"). Hyperliquid will show you a private key — a long string starting with 0x. This is shown only once. Copy it immediately and save it somewhere safe (a password manager, not a screenshot).

Note the API wallet address

After generating, Hyperliquid also shows you the wallet address (public address, e.g. 0xABCd...1234) of the API wallet. This is different from your main wallet address. You will need both: the API wallet's private key and the API wallet's address — not your main wallet's address.

Go to Account → Exchanges → Add connection

In MyLiquidBot, click your avatar or account name in the top-right → Exchanges → Add connection. You will see a form with exchange options.

Select Hyperliquid and fill in the fields

Choose Hyperliquid from the exchange list. Then fill in:

Save and open the Manage page

Click Save. You will be redirected to the Exchanges list. Click Manage next to your new Hyperliquid connection to open the management page.

Click "Test API and fee status"

On the Manage page, click the Test API and fee status button. MyLiquidBot will contact Hyperliquid and show a result:

✓ API Hyperliquid accessible — the credentials are valid and the account can be read. You will also see Builder Fees status (Active / Inactive / Update required).

✗ Error — the credentials are wrong or the API wallet does not exist. Go back to Edit and recheck the Wallet Address and API Private Key fields.

Connect your wallet and approve Builder Fees

Builder Fees is how Hyperliquid attributes orders to MyLiquidBot. It does not allow withdrawals — it only tags your orders. You need to approve it once per API wallet.

On the Manage page, click Connect wallet (or "Manage wallet"). You can either:

Option A — Browser wallet: If MetaMask or Rabby is installed, click Open wallet connect. Your browser wallet will prompt you. Connect using the main wallet that owns the Hyperliquid account (the one that holds the funds, not the API wallet address).

Option B — Manual address: Paste your main wallet's public address (0xYOUR...MAIN) into the manual field and click Save address.

After the wallet is connected, click Approve Builder Fees. MetaMask/Rabby will ask you to sign a typed message — this is not a transaction and costs no gas. Click Sign to approve.

Verify everything is green and create your first bot

After a successful test + Builder Fees approval, the Manage page shows: Wallet: Connected · Builder Fees: Approved · Active. You are ready to create bots using this connection.

Go to app.zklighter.com and connect your L1 wallet

Open app.zklighter.com. Connect an EVM wallet (MetaMask, Rabby, etc.). This is your L1 address — the on-chain owner of your Lighter account.

Go to Settings → API keys

In the Lighter interface, open Settings (top-right) → API keys. Here you can create and manage API keys for your account. Each API key has an index (0, 1, 2…) and a corresponding private key.

Create a new API key and save all values

Click Create API key. Lighter will show you:

Also note your account index — visible on the Lighter dashboard or Settings page. It is an integer that identifies your sub-account (usually 0 for the main account).

Note your L1 address

Your L1 address is the EVM wallet address you connected in step 1 (e.g. 0xYOUR...L1ADDR). You will need it for the MyLiquidBot connection form.

Go to Account → Exchanges → Add connection → Lighter

In MyLiquidBot, go to Account → Exchanges → Add connection and select Lighter. Fill in the form:

Save and open the Manage page

Click Save. In the Exchanges list, click Manage next to the Lighter connection.

Click "Test connection"

On the Manage page click the Test connection button at the top. MyLiquidBot calls the Lighter API and shows a detailed result:

✓ Connection OK — shows: account index discovered, L1 address on-chain, available balance, collateral, number of active markets, and number of API keys. It also shows a Public Key verification section that confirms whether your configured public key matches an actual API key on your account.

✗ Error — shows the specific error. Common errors: wrong account index, wrong private key, API key revoked, or account not funded.

Click "Approve Integrator Fees"

On the Manage page, find the Lighter · Integrator Fees section. Click Approve Integrator Fees. This authorizes MyLiquidBot to attach integrator metadata to orders placed through your account.

A browser wallet popup (MetaMask/Rabby) will appear asking you to sign a message with your L1 wallet (the EVM wallet connected to your Lighter account). Click Sign. No gas is required.

Once approved, the status shows Approved locally.

Use the Leverage settings panel on the Manage page

Unlike Hyperliquid, Lighter requires leverage to be configured on-chain per market before bots can operate. On the Manage page, find the Lighter · Leverage settings panel on the right side.

Search for the market, set mode and leverage, click Update

In the market search field, type the asset name (e.g. BTC). Select the market. Then:

Margin Mode — choose Cross or Isolated. Cross shares margin across all positions. Isolated limits risk to each position individually. Start with Cross if you are unsure.

Leverage — enter the multiplier you want to use (e.g. 3). The max leverage for the market is shown below the search field.

Click Update leverage on Lighter. MyLiquidBot signs and broadcasts a real updateLeverage transaction to the Lighter network. After it succeeds, the setting appears in the Locally saved leverage list below.

Verify the saved leverage and create your bot

After updating, the Locally saved leverage panel shows an entry for the market with the leverage and margin mode. When you go to create a Lighter bot, the form reads this setting and pre-fills the leverage. If the form shows a warning like "No local leverage found for this market", return to Manage and complete step 10 for that market.

Create the API key on Aster

Open Aster's API section. Create a key with read and trading permissions. Do not enable withdrawals. Save the API Key, Secret and any passphrase if Aster requires one.

Add the connection in MyLiquidBot

Go to Account → Exchanges → Add connection, choose Aster and paste the requested fields. Use an easy-to-recognize name such as Aster Main.

Test before trading

Use the test button. If Aster appears as available but a market is not ready yet, wait for the integration to finish or contact support. Do not force live bots until the test and balance load correctly.

Use without a subscription

You can trade by paying the normal platform commission. This is the simplest way to start and check if the product fits you.

Activate a plan if it makes sense

When plans are available, the VIP panel will show your level, benefits and duration. A plan may reduce fees or improve conditions if you trade frequently.

Use referrals

If you register on a DEX with official referral links or apply a code inside MyLiquidBot, you may receive discounts on commissions or subscriptions when the promotion is active.

Select exchange connection

Choose the saved API connection for the exchange you want to trade on. The available USDC balance is shown immediately. If the balance shows "Not available", the connection may need to be retested under Account → Exchanges.

Search the trading pair

Type the asset name (e.g. BTC) in the pair search. A live combobox shows all available markets with current price. Select the pair and verify the market data panel: minimum order notional, minimum coin quantity, max leverage, and decimal precision. These limits apply to every order the bot places.

Set leverage and direction

Leverage multiplies your exposure: a $100 position at 5× controls $500 of BTC using $100 margin. The margin is what you risk losing if the position is liquidated. For a first bot, use 1× or 2×. Direction — Long profits when price rises; Short profits when price falls.

Configure strategy-specific parameters

Each bot has its own entry/exit parameters. See each bot's section below for field-by-field explanations with BTC examples.

Check the level preview panel

Martingale and GridMart bots show a live preview table of all levels — entry prices, margin per level, position notional, and minimum notional warnings. Fix any ⚠ warnings before creating the bot or those orders will be rejected by the exchange.

Enable Dry Run for your first test

Dry Run simulates the bot without sending real orders. Always enable it the first time you run a new configuration. After verifying behavior in the open orders panel, disable Dry Run to go live.

Select exchange and check balance

Choose your connected exchange from the Exchange connection dropdown. The panel on the right shows your available USDC margin. Make sure you have enough to cover all planned buy levels before creating the bot.

Name the bot

A name is auto-generated (e.g. TDCA-BTC-1). Change it if you are running multiple TDCA bots on the same pair so you can tell them apart from the bot list.

Choose the trading pair

Type BTC in the pair search. The combobox shows live price and market limits: minimum order notional, minimum coin quantity, max leverage, and decimal precision. Confirm the market is liquid enough before continuing.

Set buy parameters

Amount per buy (USDC) — notional value of each individual order. For BTC on Hyperliquid the minimum notional is $10; a safe starting value is $25. The margin actually deducted equals this amount ÷ leverage.

Leverage — multiplier applied to each buy. At 1× a $25 buy uses $25 margin. At 5× the same $25 buy controls $125 of BTC but only costs $25 in margin. Higher leverage increases liquidation risk.

Direction — Long accumulates by buying dips hoping price rises; Short accumulates by selling rallies hoping price falls.

Interval (minutes) — how often the bot runs its evaluation cycle. 60 minutes is a good starting point. Shorter intervals check more frequently but do not guarantee more fills.

Max open orders — hard cap on how many unfilled buy orders can exist at once. Example: 10 orders × $25 each = $250 max notional planned. Set this to the number of dip-buying levels you are comfortable holding simultaneously.

Configure strategy filters (optional)

Buy only at better average — when checked, the bot skips buying if the current price is already above the average entry of existing open orders. This prevents adding at worse prices when you already have inventory. Enable this if you only want to lower your average, never raise it.

Margin % below average — requires price to be this percentage below the current average entry before a new buy is allowed. Example: 1.5 means the bot only buys if price is at least 1.5% below average. Leaving it at 0 means any price below average is acceptable.

Set Take Profit

Enable Automatic Take Profit and enter a percentage. This is calculated from the average entry price across all filled orders (leverage-adjusted). Example: 1.5% means if BTC's average entry is $100,000, the TP fires at $101,500. When TP fires, the bot closes the entire position and waits for the next cycle.

Choose options and create

Dry Run — simulates the bot without sending real orders. Use this first to verify the logic works as expected. If the form shows an activation option, enabled means the bot starts on the next engine cycle. GridMart Classic does not need that checkbox: it is active on creation and any price trigger controls the wait.

Select exchange, name and pair

Same as other bots. Pick the connection, confirm your balance, name the bot and search for BTC. Check the market data panel for current price, minimum notional and max leverage.

Set leverage and direction

Martingale with high leverage amplifies both returns and liquidation risk. For a first test use 2× or 3× at most. Choose Long if you expect BTC to eventually recover.

Set cooldown after TP

Cooldown (minutes) — after a full take-profit cycle closes, the bot waits this many minutes before opening a new base order. Example: 60 minutes gives the market time to settle before re-entering.

Set total investment (USDC margin)

This is the total margin distributed across the base order and all safety orders. The bot automatically calculates the base order size from this total using the volume scale multiplier. Example: $150 total margin with 6 safety orders and 2× volume scale.

The level preview panel on the right shows you exactly how the $150 gets split across each level before you submit. Check it — if any level shows a warning (⚠ below min notional), increase total investment or reduce levels.

Configure the safety order structure

Number of limit buys — how many safety entry levels the bot will place below the base entry. Example: 6 safety orders means up to 7 entries total (base + 6). More levels require more capital.

Initial separation % between levels — the percentage drop from the base entry price where the first safety order is placed. Example: 1.0% means if BTC enters at $100,000, the first safety is at $99,000.

Volume scale (size multiplier) — how much larger each safety order is relative to the previous one. Example: 2.0 means each safety is 2× bigger than the one before it. A base of $5 margin → safety 1 = $10 → safety 2 = $20 → safety 3 = $40.

Step scale (distance multiplier) — how much wider the gap between each successive safety level becomes. Example: 1.2 means each gap is 20% wider than the previous. First gap = 1%, second = 1.2%, third = 1.44%, etc. This spreads levels farther apart as price falls further.

Set Take Profit %

This is the percentage price movement above the average entry at which the bot closes the entire position. Example: 1.5% — if after filling 3 levels the average entry is $98,500, the TP fires when BTC reaches $99,977.50. This is a raw price movement, not leverage-adjusted PnL.

Review the level preview panel

Before clicking Create, check the Level preview table on the right. It shows every level's estimated entry price, the margin used, the position notional (margin × leverage), and whether each level meets the market's minimum notional. Any row with ⚠ means that level will be rejected by the exchange. Fix it by increasing total investment, increasing leverage, or reducing the number of levels.

Select exchange, name and pair

Same as other bots. Select the connection, verify balance, name the bot and search for BTC.

Set leverage and direction

GridMart is not intended for high leverage. Use 2× or 3× for a conservative setup. Long is appropriate for BTC when you expect the market to stay in a range and slowly grind up.

Set cooldown and total investment

Full-cycle cooldown (min) — after all grid sells complete a full cycle, the bot waits before starting over. Example: 60 minutes.

Total investment (USDC margin) — the total margin distributed between the base and all safety orders. Example: $150.

Configure safety order structure

Number of limit buys — safety entries below the base. Example: 6.

Initial separation % — gap from base entry to first safety. Example: 1.0% → first safety at $99,000 if base is $100,000.

Volume scale — size multiplier per safety level. Example: 2.0×.

Step scale — distance multiplier per gap. Example: 1.2×.

Set Satellite TP

Satellite TP % (above breakeven) — after safety orders fill and average entry shifts, the satellite TP is placed this % above the new average entry. It is a reduce-only order designed to unload the safety inventory. Example: 0.8% — if average entry drops to $99,000, satellite TP fires at $99,792. Keep this small so it fires quickly and frees up margin.

Configure Grid Sell levels

Grid sells are the profit-taking staircase for the core (base) position. Each level is placed progressively higher and sells a percentage of the remaining core inventory.

Quantity of grid sells — how many sell levels above current price. Example: 5.

Initial grid sell separation % — gap from current price to the first sell level. Example: 1.0% → first sell at $101,000 if BTC is at $100,000.

Grid sell distance multiplier — how spacing grows between sell levels. Example: 1.0 = uniform spacing; 1.2 = each gap 20% wider.

% of core to sell at level 1 — what fraction of core inventory is sold at the first level. Example: 20% — if core position is 0.001 BTC, the first sell targets 0.0002 BTC.

Grid sell qty multiplier — how the sold quantity scales between levels. Example: 1.0 = same percentage at every level.

Grid rebuy discount % — after a grid sell executes, a rebuy limit order is placed this % below the sell price to re-acquire inventory for the next cycle. Example: 0.5% — if a sell fires at $101,000, rebuy is placed at $100,494.50.

Review the preview and create

The level preview panel shows the full buy-side distribution. Verify no level has a ⚠ warning. Then click Create Bot.

Select exchange, name and pair

Pick the connection, confirm balance, name the bot, and search for BTC.

Set leverage and direction

Use 2× or 3× for a conservative first test. Choose Long for BTC if you expect price to recover after dips.

Set cooldown and total investment

Same as GridMart. Example: $150 total margin with 60-minute cooldown after each TP cycle.

Configure safety orders

Set Number of limit buys (e.g. 6), Initial separation % (e.g. 1.0%), Volume scale (e.g. 2.0×), and Step scale (e.g. 1.2×). The level preview panel shows the full distribution — verify no level is below minimum notional before creating.

Set the Satellite TP

Example: 0.8% above the average entry. This is the only exit mechanism — when the satellite TP fires, the bot closes the safety inventory and restarts after cooldown. Keep this tight so it fires quickly.

Pause and Resume

Pause cancels all active bot orders (safeties, satellite TP) but leaves the market position open. The position continues accumulating or losing PnL while paused. Resume re-evaluates current state and re-places the grid structure. Use Pause if you want to manually manage the position temporarily without closing it.

Select exchange, name and pair

Pick the connection, verify balance, name the bot, search for BTC and confirm market data (price, min notional, max leverage).

Choose grid spacing mode

Arithmetic — equal dollar distance between each level (e.g. every $1,000). Simpler and more predictable. Geometric — equal percentage distance between each level (e.g. every 1%). Geometric grids are better for assets with wide price ranges because spacing adjusts proportionally.

Choose order sizing mode

Quote mode — each grid level gets the same USDC margin value. This is the most common and easiest to reason about. Base mode — each grid level buys the same coin quantity (e.g. 0.001 BTC each). Use base mode if you want consistent coin accumulation.

Set lower price and upper price

Define the range. Example: Lower = $90,000 · Upper = $110,000. The grid only operates inside this range. Orders below the lower bound or above the upper bound will not be placed. Set the range wide enough to be realistic for the next trading period, but not so wide that individual levels are too far apart to fill.

Set grid levels

The number of equal intervals across the range. Example: 20 levels across $20,000 range = $1,000 spacing per level. More levels = smaller spacing = more frequent fills but smaller profit per fill. Fewer levels = wider spacing = less frequent fills but larger profit per fill.

Set total investment / per-grid margin

In Quote mode: enter Total investment (USDC margin). The per-grid amount is automatically calculated as total ÷ grid levels. Example: $200 total ÷ 20 levels = $10 margin per level. At 2× leverage, each buy is a $20 notional BTC position. Verify this exceeds the market minimum notional.

Set direction and leverage

Long — bot accumulates BTC on buy levels and takes profit on sell levels above. Short — bot shorts on sell levels and takes profit on buy levels below. For BTC in a neutral-to-bullish range, use Long. Leverage: start at 1× or 2×. Grid bots rely on fills inside the range, not on leverage to generate returns.

Enable Dry Run first, then create

Enable Dry Run to simulate without placing real orders. After verifying the bot behavior in the open orders panel, edit the bot, disable Dry Run and re-activate.

Connect at least two compatible exchanges

You need enough balance in the accounts that will act as the arbitrage legs. If you only have one exchange connected, the bot cannot hedge the position on another market.

Review the screener

AI Studio includes a funding arbitrage screener. Use it to review price/funding differences before opening a session. Do not open a trade just because the number looks high: review liquidity, fees and size.

Use conservative size

Start small. The size must support margin changes on both exchanges. If one leg fills and the other does not, you may be temporarily exposed.

Monitor the session

Review both legs, PnL, accumulated funding and errors. If you manually close one leg on the exchange, update or close the session from MyLiquidBot to avoid imbalance.

Select account and market

Choose the exchange connection and pair for a new manual order. Open manual orders are shown together so you do not need to switch DEX just to see pending TP/SL orders.

Choose order action

Use Buy/Sell for new manual entries, Close Position for reduce-only market exits, Take Profit for trigger/reduce-only profit exits, and Stop Loss for trigger/reduce-only protection where supported.

Review quantity and trigger

Quantity controls how much exposure is affected. Trigger price controls when TP/SL activates. A wrong trigger can close too early or not protect you.

Cancel manual TP/SL if needed

Open manual TP/SL orders show a Cancel action when the platform has the exchange order id and the order is still active.

Open Account → Telegram

Use the Telegram section in your profile to start linking.

Generate link

The platform creates a unique link/token for your account. Do not share it.

Confirm with the bot

Open Telegram, confirm the link, then return to MyLiquidBot and verify the status changed.