> For the complete documentation index, see [llms.txt](https://docs.hipersnipe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hipersnipe.com/features/trading-ui.md).

# Trading UI

The Trading UI is the per-token dashboard opened when you paste a contract address (CA) anywhere in chat.

## Opening the UI

Paste any of:

* Raw Solana mint address (base58)
* Pump.fun link containing the mint
* DexScreener link containing the mint

`handlers/trading_ca_handler.py` detects the CA and renders the dashboard.

## Dashboard sections

### Header

* Bot branding, token name, symbol, full CA (tap to copy)
* Wallet SOL balance

### Market overview

* Price, age, market cap, liquidity
* Volume (5m / 24h)
* Platform: Pump.fun or Raydium

### Security and trust

* Mint / LP / freeze status icons
* RugCheck result (SAFE / DANGER)
* Bundle check (PASS / FAIL)
* Dev sold indicator
* Dex paid status

### Your position (when holding)

| Line      | Content                                                       |
| --------- | ------------------------------------------------------------- |
| Position  | Token balance + USD value                                     |
| Avg Entry | SOL price + entry MC                                          |
| Invested  | Total cycle SOL spent + USD (`invested_sol × live SOL price`) |
| Status    | OPEN / CLOSED / Syncing                                       |
| Chart     | Realized + Unrealized PnL for current cycle + ROI %           |

### Footer

* `Updated: HH:MM:SS UTC | 👥 Buyers: N`

## Keyboard actions

| Button         | Action                                  |
| -------------- | --------------------------------------- |
| Buy presets    | Execute buy at configured SOL amounts   |
| Sell %         | Sell 25/50/100% or custom               |
| Sell Initials  | Sell amount equal to initial cost basis |
| 🛡️ Shield row | Open Trading Shield config              |
| Limit Order    | Create price-triggered order            |
| Refresh        | Reload balances and metadata            |
| Slippage cycle | Rotate slippage preset                  |
| Social links   | Twitter, Telegram, DexScreener, Solscan |

## Two-stage render

For speed, the UI may render market data first (Stage 1) and patch security audit results in place when RugCheck/dev checks complete (Stage 2).

## Performance logs

Look for `UI SPEED: Total: Xms` in `bot.log` to diagnose slow refreshes.

## Related

* [Buy and sell execution](/features/buy-sell.md)
* [Trading Shield](/features/trading-shield.md)
* [Analytics and PnL](/features/analytics-pnl.md)


---

# 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://docs.hipersnipe.com/features/trading-ui.md?ask=<question>&goal=<endgoal>
```

`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.