# Signal Commands

## What are trading signals?

A trading signal is a data-driven indicator that suggests an asset may be worth paying attention to. Signals do not tell you what to do, they give you a ranked view of which markets are showing interesting conditions based on measurable factors like price momentum, volume, and market sentiment.

Byreal Perps Agent Skills includes a built-in signal scanner that analyses the top 30 assets on Hyperliquid by 24-hour volume and scores each one from 0 to 100. The higher the score, the more confluent the conditions are across the factors the scanner measures.

Signal commands do not require a funded account. They run on public market data.

## What does the scanner measure?

The scanner scores each asset across four factors:

**Momentum (30% of score)**\
How much the price has moved in the last 24 hours. Strong momentum in either direction suggests the market is active and trending, which can create better trading conditions than a flat, low-activity market.

**Volume (25% of score)**\
How much of the asset has been traded in the last 24 hours. High volume means the market is liquid, which matters because it affects how easily you can enter and exit without moving the price against yourself.

**RSI (25% of score)**\
RSI stands for Relative Strength Index. It is a momentum indicator that measures whether an asset is overbought or oversold on a scale of 0 to 100. Values below 30 suggest the asset has been heavily sold and may be due for a bounce. Values above 70 suggest it has been heavily bought and may be due for a pullback. The scanner uses a 14-period RSI calculated from 4-hour candles.

**Funding rate (20% of score)**\
In perpetual futures, a funding rate is periodically paid between long and short traders to keep the perps price anchored to the spot price. A high positive funding rate means longs are paying shorts, which suggests the market is heavily long-biased. A high negative rate means the opposite. Extreme funding rates can signal crowded trades and potential reversals.

## Signal tiers

Based on the composite score, assets are grouped into three tiers:

| Tier         | Score        | What it means                                                            |
| ------------ | ------------ | ------------------------------------------------------------------------ |
| Aggressive   | 65 and above | Strong confluence across multiple factors. Higher potential, higher risk |
| Moderate     | 45 to 64     | Mixed signals. Conditions are interesting but not strongly aligned       |
| Conservative | Below 45     | Low activity or unclear conditions                                       |

## Using the scanner

To scan all top markets and get a ranked list of signals:

```bash
byreal-perps-cli signal scan
```

To get a full technical breakdown for a single asset:

```bash
byreal-perps-cli signal detail ETH
```

The detail view shows the individual factor scores, RSI value, current funding rate, and 24-hour volume, giving you a clearer picture of why an asset scored the way it did.

## Signal commands summary

| Command                | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `signal scan`          | Scan the top 30 markets and return ranked signals |
| `signal detail <coin>` | Full technical breakdown for a single asset       |


---

# 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.byreal.io/byreal-perps-agent-skills/signal-commands.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.