> 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/links/screener-agent-osprey-v1.md).

# Screener Agent (Osprey V2)

## What is Osprey

Osprey is a HawkFi Screener Agent designed to catch runners early, screening top pools 24/7 for opportunities most humans would miss.

It stays awake around the clock, watches token activity, catches daily runners, and routes winning opportunities into HawkFi agents.

{% hint style="info" %}
Osprey V2 is live in beta in the HawkFi agent creation flow as an `Entry Model`.
{% endhint %}

## Agent Overview

### The Osprey Agent

| Agent                                    | Benchmark                                      | Best for                                  | Behavior                                                                      | Status     |
| ---------------------------------------- | ---------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------- | ---------- |
| Osprey High Volume 5M V1                 | Earlier 7d benchmark: catches \~67% of runners | Selective runner detection from top pools | Deprecated version of the high-volume screening flow.                         | Deprecated |
| Osprey V2 High Volume 5M **(Selective)** | 14d: catches \~70% of daily runners            | High confidence opportunities             | Prioritizes stronger setups with fewer, more focused entries.                 | Live beta  |
| Osprey V2 High Volume 5M **(Degen)**     | 14d: catches \~62% of daily runners            | Broader market opportunity coverage       | Prioritizes maximum opportunity coverage with faster, less selective entries. | Live beta  |

#### What counts as a runner

A runner is a top opportunity that Osprey was expected to catch.

In this context, a top opportunity means a token represented by one of the highest-ranking HawkFi pools in the evaluation snapshot. These pools are usually ranked by recent pool fees, such as the latest 24-hour fees.

The benchmark maps each pool to its subject token, excludes denominator assets where appropriate, and checks whether the filtered high-volume agent alerted that token inside the report window.

In simple terms:

```
A runner is a top-pool token Osprey should have caught.
```

#### Current HawkFi Benchmarking Study

Osprey V2 High Volume 5M (Selective) currently catches \~70% of daily runners in the beta benchmark.

Osprey is not being framed around how many alerts it sends. It is being framed around how many runners it catches before they become obvious.

```
Runners caught = daily runners caught by Osprey / all eligible daily runners
```

The simple read: Osprey finds the market while humans are still watching scattered token feeds, pool pages, and noise.

{% hint style="info" %}
The \~70% figure is the current beta benchmark for runners caught with `Osprey V2 High Volume 5M (Selective)`.\
\
Agent improvements are expected over time.
{% endhint %}

## Why use Osprey

Most token opportunities are easy to miss manually. Tokens move fast, rotate fast, and often become obvious only after the best window is gone.

HawkFi made the Osprey agent to built that gap. It monitors the market continuously 24/7, applies a repeatable screening, and catches a meaningful share of the daily runner universe before manual monitoring would usually react.

{% stepper %}
{% step %}

### Easy & Instant

No manual setup, coding, or stitching tools together. Osprey is live inside HawkFi agents and can be configured in clicks.
{% endstep %}

{% step %}

### Quant Optimized

No guesswork. Osprey is benchmarked against runners caught, win rate, and PnL outperformance studies, with an agent that can keep learning and improving over time.
{% endstep %}

{% step %}

### Battle Tested Execution

Osprey routes opportunities into HawkFi's high frequency LP execution stack, built on one of the most proven LP automation engines on Solana..
{% endstep %}
{% endstepper %}

## Quick Start Tutorial

{% embed url="<https://youtu.be/asB2K4O3fVI>" %}

Use the video when available, or follow the key setup steps below.

{% stepper %}
{% step %}

### Fund the Agent wallet.

Add SOL to your `Agents Funds` before turning it live.
{% endstep %}

{% step %}

### Configure Agent settings

Set your `Entry Agent`'s settings: Fixed Position Size, Maximum Open Positions, etc.\
\
Default settings also works!
{% endstep %}

{% step %}

### Pick the Screening Agent (Osprey V2)

Choose `Osprey V2 High Volume 5M (Selective)` as the Screening Agent.
{% endstep %}

{% step %}

### Pick your Execution Models

Choose how HawkFi entry agents' should execute agent once Osprey finds an opportunity, like Precision Flip — for maximizing fees during volume spikes and.maximizing trading PnL during volatility spikes.\
\
Wanna dive deep about the Execution Models? Check [HawkFi Models](/whitepaper/hawkfi-or-high-frequency-liquidity/hawkfi-models.md)
{% endstep %}

{% step %}

### Set manual exit or TP/SL targets.

Decide whether you want to exit positions manually or use take profit and stop loss targets.
{% endstep %}

{% step %}

### Review and launch.

Confirm the agent wallet's funding, settings, entry agent, execution model, and exit rules before activating the agent.
{% endstep %}
{% endstepper %}

## FAQs for Osprey

<details>

<summary>I deployed the Osprey agent. Why has it not deployed LP into any position?</summary>

`Osprey V2 High Volume 5M (Selective)` is selective by design. It waits for higher confidence entries instead of forcing constant positions.

If you want broader opportunity coverage, `Osprey V2 High Volume 5M (Degen)` targets more entries. Higher frequency comes with tradeoffs: more entries, more activity, and higher risk.

</details>

## More Questions?

Join the HawkFi Discord for questions and discussions: <https://discord.com/invite/hawkfi>