# Fills & PNL

***

### Overview

Every time an order executes, it generates a **fill**, a record of exactly what was traded, at what price, and what you paid in fees. Combined with portfolio and fee views, you get a complete picture of how your trading is performing on Hyperliquid.

**What you can do:**

* View recent fills with execution prices and fees
* Track unrealized PnL on open positions in real-time
* Review realized PnL from closed trades
* Analyze portfolio performance over time
* Check your fee tier and total fees paid
* Query historical fills by time range

***

### Recent Fills

Fills are your executed trades. Every market order, limit fill, stop-loss trigger, and take-profit execution generates a fill.

| Prompt                           | Interpretation                 |
| -------------------------------- | ------------------------------ |
| "Show my recent fills"           | All recent trade executions    |
| "What trades have I made today?" | Fills from today               |
| "Show my last 10 fills"          | Most recent executions         |
| "What did I trade this week?"    | Fills from the past 7 days     |
| "Show my BTC fills"              | Filters to BTC executions only |

#### What You'll See

For each fill:

| Field          | What It Shows                                     |
| -------------- | ------------------------------------------------- |
| **Asset**      | The token traded (BTC, ETH, SOL, etc.)            |
| **Side**       | Buy or Sell                                       |
| **Direction**  | Open Long, Open Short, Close Long, or Close Short |
| **Price**      | The exact execution price                         |
| **Size**       | Quantity in contract units                        |
| **Notional**   | USD value of the fill                             |
| **Fee**        | Fee paid (negative means you earned a rebate)     |
| **Order Type** | Market, Limit, Stop-Market, etc.                  |
| **Time**       | When the fill occurred                            |

***

### Unrealized PnL

Unrealized PnL is the profit or loss on your **currently open** positions. It's what you'd make or lose if you closed right now. It changes with every price tick.

```
Long:  Unrealized PnL = (Current Price - Entry Price) × Size
Short: Unrealized PnL = (Entry Price - Current Price) × Size
```

| Prompt                               | Interpretation                             |
| ------------------------------------ | ------------------------------------------ |
| "What's my unrealized PnL?"          | Sum of PnL across all open positions       |
| "How much am I up on BTC?"           | BTC position PnL in dollars and percentage |
| "Am I profitable right now?"         | Overall unrealized PnL snapshot            |
| "Which position is doing best?"      | Ranks positions by PnL performance         |
| "Which position is losing the most?" | Identifies worst performer                 |

**Example:**

| Asset | Side  | Size   | Entry Price | Mark Price | Unrealized PnL | ROE   |
| ----- | ----- | ------ | ----------- | ---------- | -------------- | ----- |
| BTC   | Long  | $5,000 | $96,500     | $97,200    | +$36.27        | +3.6% |
| ETH   | Short | $2,000 | $3,450      | $3,380     | +$40.58        | +8.1% |
| SOL   | Long  | $1,000 | $148.50     | $145.20    | -$22.22        | -4.4% |

{% hint style="info" %}
Unrealized PnL only becomes realized when you close the position.
{% endhint %}

***

### Realized PnL

Realized PnL is the actual profit or loss from **closed** trades. Once a position is closed, the PnL is locked in and added to your account balance.

| Prompt                                      | Interpretation                        |
| ------------------------------------------- | ------------------------------------- |
| "What's my realized PnL?"                   | Total profit/loss from closed trades  |
| "How much did I make on my last BTC trade?" | PnL from most recent BTC close        |
| "Show my realized PnL this week"            | Closed trade PnL over the past 7 days |
| "How much have I made today?"               | Today's realized PnL                  |
| "What was my worst trade this month?"       | Largest realized loss                 |

***

### Portfolio Performance

Get a high-level view of your overall account performance over time.

| Prompt                          | Interpretation                    |
| ------------------------------- | --------------------------------- |
| "Show my portfolio performance" | Full account performance overview |
| "How's my perps account doing?" | Portfolio snapshot with total PnL |
| "What's my account value?"      | Current equity and margin usage   |
| "Show my PnL history"           | Performance over time             |

**Portfolio includes:**

* Total account equity
* Total realized PnL (cumulative)
* Total unrealized PnL (current)
* Margin usage and free margin
* Historical performance

***

### Historical Fills

Query fills from a specific time period for deeper analysis.

| Prompt                                 | Interpretation                  |
| -------------------------------------- | ------------------------------- |
| "Show my fills from the last 24 hours" | Fills from the past day         |
| "What trades did I make last week?"    | Last 7 days of fills            |
| "Show all my SOL fills this month"     | SOL-specific fills over 30 days |
| "Show fills from January"              | Fills within a specific month   |
| "My trading history since Monday"      | Fills from start of the week    |

The agent handles time conversion automatically. Just say "last week", "today", "since Monday", or any natural timeframe.

***

### Understanding Your Trade Flow

Here's how a complete trade maps to fills and PnL:

```
1. Open Position
   "Long $1000 of BTC"
   → Fill generated: "Open Long" at execution price
   → Position appears in your positions view
   → Unrealized PnL starts tracking

2. Price Moves
   → Unrealized PnL updates in real-time
   → No new fills (nothing executed)
   → Funding payments may accrue

3. Close Position
   "Close my BTC position"
   → Fill generated: "Close Long" at execution price
   → Realized PnL = Close Price - Entry Price (× size, minus fees)
   → Position removed from positions view
   → Margin freed back to account
   → Realized PnL added to portfolio history
```

***

### Funding Impact on PnL

Funding payments are included in your realized PnL and can meaningfully affect your returns on longer holds.

* **Positive funding, you're long**: You're paying. This eats into your PnL over time.
* **Positive funding, you're short**: You're earning. This adds to your PnL.
* **Negative funding, you're long**: You're earning.
* **Negative funding, you're short**: You're paying.

| Prompt                                  | Interpretation                        |
| --------------------------------------- | ------------------------------------- |
| "How much funding have I paid?"         | Cumulative funding payments           |
| "Is funding eating into my BTC profit?" | Checks funding impact on BTC position |

{% hint style="info" %}
**Tip**: If you're holding a position for days or weeks, check the funding rate. A 0.01% funding rate paid every 8 hours adds up to \~1.1% per month.
{% endhint %}

***

### Pro Tips

1. **Check unrealized PnL before closing** - Make sure you're exiting at a level you're comfortable with
2. **Use limit orders to reduce fees** - Maker rebates add up significantly over time
3. **Track funding payments** - On longer holds, funding can eat into profits or boost returns
4. **Review fills after stop-losses trigger** - Verify execution price matched expectations, especially in volatile markets
5. **Monitor margin usage** - Low free margin means higher liquidation risk
6. **Compare entry vs average price** - If you scaled into a position, your average entry may differ from individual fills

***
