Connection and security
Can I start arbitrage as soon as the API connects?
First verify the private stream, account type, product switches, balances, positions and orders. Then check A buy / B sell, quantity units, minimums, position cap and batch amount. Adding an account or watchlist entry is not trading verification. Enabling a strategy or opening manually may create real orders.
Why can I see prices but not balances?
Public prices usually need no private permissions. Check the error code, matching credentials, passphrase, IP allowlist, clock, site, mainnet/testnet and the account holding the funds. Public data does not validate private credentials.
Do I need withdrawal permission?
No. The form requires trading without withdrawals. Disable withdrawals and review other funds permissions individually. Trading access can still be abused to cause losses.
Should the IP allowlist use my computer or server?
Use the public egress that actually sends exchange requests. Confirm the deployment’s fixed API egress with its operator, including proxies and routing. Do not substitute DNS addresses, home IPs or private addresses such as 192.168.x.x. Recheck after egress changes; do not remove the allowlist to troubleshoot.
Can I send API screenshots to support?
Send redacted permission pages, error codes and times only. Hide keys, secrets, passphrases, API wallet private keys, QR codes and sensitive account data. Support does not need full credentials or seed phrases.
What if API credentials leak or may be stolen?
Stop strategies, revoke the key or agent on the exchange and check positions, open orders and asset records. Revocation does not cancel old orders or close positions automatically. Handle remaining exposure on the exchange, create dedicated credentials again and review permissions; changing only the tool password is insufficient.
Does CORS, HTTP 451 or a timeout mean the API is broken?
Check browser cross-origin restrictions, regional access restrictions and routing separately. CORS is not a signature error; recreating keys does not fix 451. Use supported secure connections and keep browser security enabled.
What if an old key suddenly stops working?
Check expiry, egress IP changes, permissions, main/subaccount changes and official notices. Pause automatic execution and retain redacted errors. Query existing orders before restarting to prevent duplicates.
How do read-only, read-write and API wallets differ?
Read-only keys generally cannot trade; read-write permits authorized trading or other modules. An API wallet signs as an agent and must not be assumed read-only. The form requires trading without withdrawals. Public prices need no account; purely read-only credentials may not pass Verify and save.
What if I forgot to save the secret or API wallet private key?
Never use screenshot examples or your main-wallet private key. Check the official page for recovery; if unavailable, create a new key/agent and revoke unused old authorization. Save the new credentials, update the tool and verify account reads first.
Where do I enter credentials, and is Saved enough?
In Settings select an unadded exchange, or Add under All exchanges. Enter the account name and documented fields, then confirm Verify and save. Continue checking private-stream status, last sync, type, products, balances, positions and orders; Saved is not full verification.
Why is the account empty? Can I place an order to test it?
Do not test a connection with real orders. A new account may truly be empty; verify successful query time and identity. Errors, loading and empty results differ. Hyperliquid main accounts leave subaccount address blank. For Aster check agent authorization, V3 compatibility and official deposit prerequisites, not nonexistent address fields.
How do I resolve timestamp, signature or nonce errors?
Check automatic clock synchronization on the execution host, then matching credentials, passphrase, environment and API version. Nonces prevent replay; sharing an agent across processes can cause conflicts. Stop duplicate execution and ask technical support. Do not repeatedly resend orders.
What changes after moving computer, server or browser?
Credentials are encrypted on the server, not only in your browser. On a new computer confirm the same trusted deployment. On a new server check egress IP, sync and whether the old service still runs. Query existing orders/positions to avoid duplicate services. Encryption implementation and server security were not audited here.
Arbitrage basics
What are S-S, S-F and F-F?
Spot/spot, spot/futures and futures/futures. Match the actual asset, quantity and quote units; similar names do not establish identical assets. Observe F-F first and verify it fully before considering execution.
Which directions are A and B?
Add spread identifies A as the buy leg and B as the sell leg. Swap legs reverses them. This product does not use +A-B / -A+B direction buttons. Check each account, product and native symbol before entry; exits reduce actual positions in the opposite direction.
Why can a positive spread still lose money?
The display may use last-trade prices rather than executable depth. Include both legs’ entry/exit fees, slippage, funding, borrowing, transfer/on-chain costs and the spread at exit.
Should I use the last price, bid or ask?
For buying A use A’s asks; for selling B use B’s bids. Estimate volume-weighted execution across the required depth. Even top-of-book prices can understate slippage.
How do I calculate the entry spread?
Check Difference / Ratio and its units. Ratio mode displays A/B; a reversion ratio changes entry/exit thresholds to deviations from that target. The examples below explain prices and costs, not a confirmed product formula. Do not transfer thresholds between calculation bases.
Who pays when funding is positive?
Under common perpetual rules, longs usually pay shorts for positive rates and the reverse for negative rates; the contract’s official rules govern. Calculate each leg separately. A single rate is not the portfolio return.
Is a high funding rate enough reason to enter?
Check the settlement time, whether you hold across it, whether the rate is predicted, caps and price risk. Rates can change before settlement. Annualized figures do not guarantee principal or returns.
Can I compare funding rates directly across exchanges?
Align settlement intervals, signs and observation times, then calculate each leg’s actual payments over the same holding period. Do not directly compare hourly and eight-hour rates.
Are two 100 USDT legs fully hedged?
Not necessarily. Match actual asset exposure, accounting for multipliers, linear/inverse contracts, fill prices and partial fills. Convert both legs to the same underlying asset quantity.
Do I need inventory before selling spot?
Regular spot selling requires inventory. Borrowing to sell needs separate verification of margin access, borrowing limits, interest and repayment. S-S typically needs quote currency on the buy side and the asset on the sell side, or another verified funding path.
Can same-name assets, 1000-unit contracts or stock tokens be paired directly?
Check underlying asset, token address/mapping, multiplier, trading hours, settlement currency and linear/inverse structure. Convert 1000-unit contracts correctly. Stock tokens, indices and perpetuals may have different rights and price mechanisms; do not assume a complete hedge.
Are margin mode, position mode and leverage the same setting?
No. Margin mode defines shared risk funds; position mode defines net or simultaneous long/short holdings; leverage affects required margin and risk. Check all separately. One-way mode can short. Cross margin or higher leverage is not a universal connection fix.
Orders and errors
Why was no order placed after the threshold was reached?
Check execution enabled, direction, data freshness, depth, available balance/margin, quantity minimums, rate limits and risk blocks. Record the time, quote and blocking reason.
Does a successful order request mean it filled?
No. Distinguish accepted, open, partly filled, filled, canceled and rejected states using exchange order/fill records. Two accepted requests do not establish a hedge.
What if one leg fills and the other fails?
Pause loops and new orders. Query actual order states, cumulative fills and positions on both sides. Determine the exposure, then follow your predefined exposure and stop-loss plan to complete the hedge or exit. Do not blindly resend the original order.
Can I retry immediately after a timeout?
Do not immediately resend a write request. The exchange may already have accepted it. Query by order ID or client order ID before deciding whether to submit again.
How do I handle minimum-size, NOTIONAL or precision errors?
Check minimum asset quantity, minimum notional, quantity and price increments, and contract units on both sides. Do not sharply increase order size merely to bypass an error.
Are market orders guaranteed to fill?
No. Exchange protection, price limits, depth and IOC rules can reject or partly fill an order; price can slip. Check market rules and verify exposure after execution.
Why did closing create a new position?
Check exit direction, position mode, positionSide / posSide, reduceOnly and actual holdings. API requirements vary. Verify remaining positions even after using the product’s close flow.
Why is the balance large but available funds insufficient?
Total assets, available balance and available margin differ. Check funding/trading accounts, subaccounts, order reserves, margin and borrowing liabilities. Funds in another account do not automatically become available margin.
Can multiple tools trade the same account?
This increases position changes, cancel conflicts and duplicate-order risk. Prefer a dedicated subaccount. Agent-signing systems such as Hyperliquid should also use separate agents per process to avoid nonce conflicts.
What should I do about 429, rate limits or maintenance?
Stop repeated refresh/retries, record the code and time, and wait or reduce request frequency under official limits. Stop new exposure during maintenance. Query unknown orders before submitting again; follow the exchange’s response for wait times.
Can I trade when spreads freeze or the network disconnects?
Check last update time, connectivity and official prices. Pause new execution when data is stale or connection state uncertain, and check positions/orders on the exchange. Browser disconnection does not mean the server strategy stopped. Verify existing trades before resuming.
Daily operation
Does Single round mean a single order?
No. It pauses after one complete entry and exit, which may involve multiple batches. It is not another tool’s Once mode. Enabling a strategy trades automatically. Define a small position budget, batch limits and an exception exit plan before deciding to execute.
Why can a hedged position still be liquidated?
Each exchange manages margin independently; profit on one side does not automatically fund the other. Price volatility, mark-price differences and maintenance-margin changes may liquidate one leg. Monitor each leg’s margin and liquidation distance.
When should I exit?
Define profit, maximum loss, holding time, funding reversal, margin, liquidity and system-failure exit conditions before entry. After exiting, check both positions, open orders, loans and final statements.
What should I check before daily operation?
Check API expiry/permissions, quote times, open orders, both positions, available margin, funding settlements, loans, maintenance and network status. Do not increase exposure before unexplained issues are resolved.
How do I calculate actual net profit?
If realized P&L is gross: net = both legs’ gross P&L + funding received − funding paid − entry/exit fees − borrowing interest − transfer costs. Do not deduct costs twice if the exchange already includes them. Separate unrealized P&L for open positions. Transfers are not profit.
What should I provide when contacting support?
Exchange, market, account mode, action time/timezone, redacted order IDs, error code, expected and actual behavior. For partial fills add both legs’ cumulative fills. Never provide full credentials.
Does pausing, closing the page or revoking an API close positions?
Do not assume so. Stopping triggers, canceling orders and closing positions are separate. Remote services may keep running after the page closes. Verify triggers have stopped and check remaining orders, positions and loans; after revocation use the official page as needed.
What should I check after closing spot margin?
Check borrowed principal, interest and automatic repayment. Completed fills do not establish repaid debt. Repay any remaining liability under exchange rules and verify it; zero leg positions alone do not complete the round.
When should I avoid restarting or increasing exposure?
Stop new actions when a single leg is unresolved, order state is unknown, prices are stale, margin is insufficient, keys may have leaked, mode is unclear or recovery may duplicate execution. Reconcile exposure, orders and loans before resuming within the original limits.
Product controls
How do Account enable, Allow trading and Enable strategy differ?
Account enable controls synchronization across its markets. Allow trading lets a product act as a trading leg. Enable strategy runs spread rules automatically. The first two are not entry actions or substitutes for closing. Understand existing positions and orders before changing any switch.
What do Open to cap and Close position do?
Open to cap starts a manual entry toward the strategy position limit, not a minimum test order. Close position trades to clear that spread. Neither is a connectivity test. Only interface labels were reviewed here; fill details and confirmations were not live-tested.
How do Block entry, Block signal exit and Pause differ?
Block entry stops opening while exits continue. Block signal exit stops signal-based exits, but stop loss and risk reduction remain active. Pause/Enable strategy controls automatic execution. Reduce-only does not apply while the strategy is paused. None establishes that old orders were canceled.
How do batch amount, position cap and exchange minimums interact?
The cap uses the larger leg’s notional and limits entries only. Batch amount is a range informed by depth and exchange minimums. If the minimum exceeds the batch cap or remaining capacity, do not repeatedly click to force fills; recheck both quantity conversions and the risk budget.
How do Reverify, Replace and Remove account differ?
Reverify reads type, permissions and products again. Replace verifies the same exchange account before changing credentials; failure keeps the old key. Removal leaves price-only access and retains order/fill history. Removal does not revoke the exchange key or close positions.
Can Close all and reset troubleshoot a connection?
No. This dangerous action stops automatic orders and clears orders, positions and balances exchange by exchange, then resets trading state on success. It can affect the whole account system. It is not reconnect or a substitute for querying one problematic order.
Are dashed chart lines executable spreads?
No. With no local data, the detail view may estimate from exchange trade prices and labels the dashed line non-executable. Use current depth, update times and the matching metric for entry/exit decisions; historical estimates are not executable quotes.
Does two-leg trading guarantee simultaneous full fills?
No. First-leg preference offers Auto / A first / B first, so execution order matters. Acceptance on one side does not establish a fill on the other. Check actual fills, remaining orders and net exposure; stop new actions on connection or leg failure.
Why can I view a market but not select it as a trading leg?
Without an account, only prices are available. A product set to price-only also cannot be a trading leg. Check account verification, enabled synchronization and Allow trading. Market-data connectivity is not order permission.