# Security and wallet safety

Security and wallet safety explains what Proliquid stores, what your wallet authorizes, and which controls protect sensitive trading information.

Proliquid separates the app account from the connected wallet: the account saves your workspace, while the wallet authorizes Hyperliquid trading actions.

## Proliquid account vs wallet

<table><thead><tr><th width="191.91015625">Layer</th><th>What it is for</th><th>Examples</th></tr></thead><tbody><tr><td>Proliquid account</td><td>Saves your app workspace and preferences.</td><td>Layouts, watchlists, settings, source preferences, sound alerts, compare presets.</td></tr><tr><td>Wallet connection</td><td>Proves wallet ownership and enables Hyperliquid trading actions.</td><td>SIWE signature, builder-fee approval, API agent creation.</td></tr><tr><td>Hyperliquid account</td><td>Holds exchange-level balances, positions, orders, fills, and margin state.</td><td>Perps account balance, positions, open orders, funding payments.</td></tr></tbody></table>

Creating an account or connecting a wallet does not place trades. Trading actions still require Terminal, news quick-trade, or position-management controls.

## Wallet connection flow

Wallet connection has three main steps:

1. **Sign in with Ethereum.** You sign a message to prove that you control the wallet address.
2. **Approve builder fees.** You approve the maximum Proliquid builder-fee rate used on supported builder-fee order actions.
3. **Create an API agent.** Hyperliquid authorizes an API agent so Proliquid can submit trading actions without asking for a wallet signature on every order.

The API agent is wallet-specific; switching wallets uses a separate connection.

## API agent storage

The API agent is saved per wallet in browser storage, which makes reconnecting faster on the same browser.

What this means in practice:

* Switching wallets in your wallet extension can use the matching wallet-specific agent when it is still valid.
* Clearing browser data can remove locally stored agent data.
* Using a new browser or device may require reconnecting and creating the agent again.
* Disconnecting in Proliquid ends the current app session for that wallet, but it does not close Hyperliquid positions or cancel open orders.

Before clearing browser data, switching devices, or signing out during active trading, review [Open orders](/terminal-sections/open-orders.md), [Open TWAPs](/terminal-sections/open-twaps.md), [Open chases](/terminal-sections/open-chases.md), and [Positions](/terminal-sections/positions.md).

## Builder-fee approval

Proliquid asks for builder-fee approval during [Connect wallet](/getting-started/connect-wallet.md) when needed. The approval is for the maximum builder-fee rate; your VIP tier can reduce the fee actually applied on supported order actions.

Builder fees are separate from Hyperliquid exchange fees. Review [Fees and trading costs](/getting-started/hyperliquid-trading-fees-and-proliquid-builder-fees.md) for the formula, VIP tiers, and examples.

Hyperliquid builder-code permissions are exchange-level permissions. Use the official [Hyperliquid builder codes](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes) documentation for source-of-truth behavior and revocation details.

## Disconnecting and switching wallets

Use disconnect when you want to stop using the current wallet in Proliquid.

Disconnecting does not:

* Close open positions.
* Cancel open orders.
* Stop exchange-level state from changing.
* Revoke all exchange-level permissions by itself.

When switching wallets, confirm the active wallet address and selected account before submitting orders. If you use multiple wallets, also confirm the [Account](/terminal-sections/account.md), [Balances](/terminal-sections/balances.md), and [Positions](/terminal-sections/positions.md) blocks match the wallet you intend to trade from.

## What Proliquid cannot do

Proliquid is an interface for market intelligence and Hyperliquid execution. It does not replace exchange-level review.

Proliquid cannot:

* Recover a wallet seed phrase.
* Guarantee that browser-local data survives clearing browser storage.
* Change Hyperliquid exchange rules for margin, liquidation, matching, or fees.
* Prevent market movement, slippage, or liquidation.
* Cancel orders or close positions unless you submit the relevant action.

For exchange mechanics, use the official [Hyperliquid documentation](https://hyperliquid.gitbook.io/hyperliquid-docs/) as the source of truth.

## Safe operating checklist

Before submitting orders from Proliquid:

1. Confirm the active wallet.
2. Confirm the selected Hyperliquid market.
3. Review size, side, margin mode, leverage, reduce-only, TP / SL, and slippage.
4. Check [Account](/terminal-sections/account.md), [Orderbook](/terminal-sections/orderbook.md), and [Positions](/terminal-sections/positions.md).
5. Monitor activity after submitting through [Open orders](/terminal-sections/open-orders.md), [Trade history](/terminal-sections/trade-history.md), and [Order history](/terminal-sections/order-history.md).


---

# Agent Instructions: 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:

```
GET https://docs.proliquid.xyz/getting-started/security-and-wallet-safety.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.