> For the complete documentation index, see [llms.txt](https://hawkfi.gitbook.io/whitepaper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hawkfi.gitbook.io/whitepaper/hawkfi-agents/monitor-and-manage-your-agent.md).

# Monitor and Manage Your Agent

Use the HawkFi Agents page to check how much capital is deployed, what the Agent is doing, and whether its current behavior still fits the setup you intended.

## What to monitor

| Agent type           | Start with                                                                 | What to check                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Market Making Agent  | `Agent Portfolio`, the Agents table, and the Dynamic Limit Order dashboard | Vault value, idle inventory, open-order value, bid and ask placement, fills, markout, and inventory drift.                                             |
| Screener Agent       | The Agents table and shared Open Positions table                           | Whether Osprey has opened a position, position value, unclaimed fees, unrealized PnL, and the position management or exit rules attached to the setup. |
| Osprey Trading Agent | The Agents table and shared Open Positions and Closed Positions tables     | Agent portfolio balance, open and closed trades, entry and exit transactions, unrealized or realized PnL, and manual exit controls.                    |

## Share your results

Open a PNL Card from a supported Agent row by clicking `PROFIT`, or select `PNL Card` in Market Making Agent Analytics. Switch between USD and SOL, hide or show stats, then download or copy the image.

## Monitor a Market Making Agent

`Agent Portfolio` includes Market Making Agent vault funds in `Deployed`. This includes idle inventory and value currently locked in open orders.

Market Making Agent rows in the Agents table show total vault value and a per-token breakdown in the `BALANCE` column.

For a newly funded Market Making Agent, `PROFIT` and `HODL` show `-` until the first scored fill. This avoids treating funded but not-yet-quoted capital as a loss.

### Read the Agent Health indicator

Funded Market Making Agent rows show a performance status under the agent name. The status follows the selected USD or SOL display and compares the agent with HODL in that currency.

| Status        | What it means                                                                                                         |
| ------------- | --------------------------------------------------------------------------------------------------------------------- |
| `New`         | The agent started less than one hour ago and is still establishing a track record.                                    |
| `Healthy`     | The agent has positive PnL, is ahead of HODL, or does not yet meet a `Needs watch` condition.                         |
| `Needs watch` | The agent has negative PnL and either trails HODL by more than 25%, or HODL has remained ahead for at least 48 hours. |
| `Stopped`     | The agent is paused or archived.                                                                                      |

Screener Agents do not show this indicator. A Market Making Agent also shows no indicator when comparison data is not available yet. Agent Health summarizes relative performance; it does not guarantee future results or report infrastructure health.

On the Dynamic Limit Order dashboard, bid and ask visuals use the same colors across the chart and bin display:

| Visual | Meaning    |
| ------ | ---------- |
| Blue   | Bid quotes |
| Orange | Ask quotes |

Use Market Making Agent Analytics and HawkFi Laboratory to decide whether the execution model still fits the pool.

| What you see                      | What it can mean                                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------------------------ |
| Too few fills                     | Orders may be too wide, the pool may be inactive, or the selected model may be too defensive.    |
| Too many bad fills                | Orders may be too tight, momentum may be one-sided, or the pool may need a more defensive model. |
| Inventory drifts too far          | Inventory skew, split, utilization, or model defensiveness may need adjustment.                  |
| High activity without better edge | Quote cadence, requote threshold, or spread factor may be too aggressive.                        |

{% hint style="info" %}
Test material changes in HawkFi Laboratory before making a live Market Making Agent configuration more aggressive.
{% endhint %}

## Monitor a Screener Agent

Screener Agent rows leave the Agents table `BALANCE` cell blank. Positions opened by Screener Agents appear in the shared Open Positions table.

`UNCLAIMED FEES` applies to Screener Agent LP positions. It does not apply to Osprey Trading Agent token trades or Market Making Agent open orders.

`UNREALIZED PNL` can appear for Screener Agent LP positions and Osprey Trading Agent open trades. In each case, it describes that LP position or token trade. It does not describe Market Making Agent open orders.

If `Osprey V2 High Volume 5M (Selective)` has not opened a position, that does not automatically mean the Agent is broken. The model is selective by design and waits for higher confidence entries instead of forcing constant positions.

## Monitor an Osprey Trading Agent

Osprey Trading Agent rows show a portfolio balance based on the agent's WSOL and current token accounts. Use the positions shortcut on the Agent row to scope the shared position tables to that agent.

Open trades show the token, age and Agent name, current token balance, original entry price, `UNREALIZED PNL`, and an entry transaction link. Select `EXIT` to review a full-position swap back to the agent's WSOL account.

Closed trades show the trade age, Agent name, `REALIZED PNL`, closure time, and `ENTRY` and `EXIT` transaction links.

{% hint style="info" %}
Osprey Trading Agent trades are token swaps. They do not use the Screener Agent LP columns for `UNCLAIMED FEES` or LP position management.
{% endhint %}

## Manage the next change

{% stepper %}
{% step %}

### Identify the behavior you want to change

Separate a funding issue, a market-fit issue, and a configuration issue before changing settings.
{% endstep %}

{% step %}

### Open the canonical setting reference

For Market Making Agent, review [Execution Models](/whitepaper/hawkfi-agents/market-making-agents-mma/execution-models.md) and [Advanced Settings](/whitepaper/hawkfi-agents/market-making-agents-mma/advanced-settings.md).

For Screener Agent, review the [Entry Settings, position management, and exit flow](/whitepaper/hawkfi-agents/screener-agents-osprey-v1.md#quick-start-tutorial).

For Osprey Trading Agent, review its [entry, allocation, filter, and full-position exit controls](/whitepaper/hawkfi-agents/osprey-trading-agent.md#current-settings-reference).
{% endstep %}

{% step %}

### Test the change when possible

Use [HawkFi Laboratory](/whitepaper/hawkfi-laboratory/hawkfi-laboratory.md) to compare a Market Making Agent configuration or LP model against the same historical pool conditions before live deployment.
{% endstep %}

{% step %}

### Change one decision at a time

Keep the reason for the change clear so you can tell whether the new behavior came from the execution model, advanced settings, position management, or exit rules.
{% endstep %}
{% endstepper %}

## Go deeper

* [Choose an Execution Model](/whitepaper/hawkfi-agents/market-making-agents-mma/execution-models.md)
* [Tune Advanced Settings](/whitepaper/hawkfi-agents/market-making-agents-mma/advanced-settings.md)
* [Find Opportunities with Osprey V2](/whitepaper/hawkfi-agents/screener-agents-osprey-v1.md)
* [Run an Osprey Trading Agent](/whitepaper/hawkfi-agents/osprey-trading-agent.md)
* [Move from Backtest to Live](/whitepaper/hawkfi-laboratory/move-from-backtest-to-live.md)
* [Solve Common Problems](/whitepaper/guides-and-support/faqs.md)