# xStocks Points Farming

**byreal-xstocks-points-mining** is a points farming skill available in both Byreal Agent Skills (via [byreal-git/byreal-agent-skills](https://github.com/byreal-git/byreal-agent-skills)) and pre-loaded in every RealClaw deployment. It opens and manages a concentrated LP position in an xStocks/USDC pool on Byreal so your wallet earns xStocks points, then runs a background watchdog that tracks your points accrual automatically.

## What It Does

The skill buys the xStock if you don't already hold it, opens a concentrated LP in the matching xStock/USDC pool on Byreal, and runs two background jobs: a position monitor that handles health checks, fee compounding, and stop-loss execution, and a points watchdog that polls the xStocks partner API and alerts you if your points stop growing.

You set it up once. The agent manages it from there.

## Supported xStocks

xStock pools are discovered at runtime from Byreal's live pool list. The skill does not use a hardcoded list.

| xStock | Underlying |
| ------ | ---------- |
| TSLAx  | Tesla      |
| AAPLx  | Apple      |
| NVDAx  | NVIDIA     |
| MSFTx  | Microsoft  |
| COINx  | Coinbase   |
| GOOGLx | Alphabet   |

If a new xStocks/USDC pool launches on Byreal, the skill picks it up automatically.

## How It Works

{% stepper %}
{% step %}
**Tell the agent which stock to farm**

> "Start xStocks mining with TSLAx. Use $500." "Farm AAPLx points for me." "Mine NVDAx points, use wide range."

The agent checks available xStock pools on Byreal, confirms the pool is safe, and surfaces the full setup for your approval: which xStock, deposit amount, price range, stop-loss if you want one, and whether to auto-compound fees.
{% endstep %}

{% step %}
**Agent buys and deploys**

If your wallet does not already hold the xStock, the agent buys the right amount first. It then opens a concentrated LP position in the xStock/USDC pool at the range you chose and records your baseline points snapshot.
{% endstep %}

{% step %}
**Two background jobs take over**

Once the LP is open, two independent jobs run on a schedule:

* **Position monitor** checks LP health every 6 hours by default. It compounds fees when they clear the threshold, triggers a stop-loss if the xStock price drops to your exit price, and alerts you if the position goes out of range.
* **Points watchdog** polls the xStocks partner API every 24 hours and records your points history. It alerts you if points stop growing while your position is in range.
  {% endstep %}

{% step %}
**Check in whenever you want**

> "How are my xStocks points?" "What's my TSLAx LP doing?"

The agent reports current points, 24-hour growth, LP value, fees earned, and whether the position is in range.
{% endstep %}
{% endstepper %}

## LP Range Presets

xStocks track equity prices and move like stocks. The range presets here are wider than stable LP strategies.

| Preset    | Range | Best for                                                                   |
| --------- | ----- | -------------------------------------------------------------------------- |
| `tight`   | ±5%   | High-conviction, active monitoring. Will go out of range on volatile days. |
| `default` | ±15%  | Balanced. Handles normal equity volatility. Recommended.                   |
| `wide`    | ±30%  | Set-and-forget. Survives earnings moves. Lower capital efficiency.         |

## Risk Controls

| Parameter       | Default                                                                                     |
| --------------- | ------------------------------------------------------------------------------------------- |
| Minimum capital | 100 USDC (300 USDC recommended)                                                             |
| IL alert        | 10% (configurable)                                                                          |
| Stop-loss       | Optional. Set an xStock USD price at startup. The agent closes the LP if the price hits it. |
| Auto-compound   | Optional. You choose yes or no at startup.                                                  |
| Range rebalance | Manual. The agent alerts you when out of range but does not auto-rebalance.                 |

{% hint style="warning" %}
xStocks are equity-tracking tokens, not stablecoins. Impermanent loss is real and can be significant on large price moves. The default ±15% range absorbs most intraday moves but will go out of range during earnings announcements or market-wide events.
{% endhint %}

{% hint style="info" %}
The skill will not open a position if the pool TVL is below 5x your deposit amount or the pool is less than 48 hours old.
{% endhint %}

## How to Start

Ask your agent naturally:

* "Start mining xStocks points. Put $500 into TSLAx."
* "Open an AAPLx LP for points farming."
* "Mine NVDAx points, use wide range."

To stop:

* "Stop xStocks mining and pull out." (closes LP, returns funds to wallet)
* "Stop xStocks mining but keep the LP." (removes automation, LP stays open unmanaged)

## Notes

* byreal-xstocks-points-mining is available for Byreal CLMM pools only. The xStock side must be paired with canonical USDC.
* The agent shows realized points and 24-hour delta from the partner API. It does not estimate points per day or project a points APR.
* Points accrue only to the agent wallet. xStocks held in a separate wallet do not count.
* If the xStocks partner API goes down, the agent pauses points polling and alerts you. The LP stays open and keeps earning fees.
* If you set a stop-loss, tighten the monitor interval to 1-2 hours. At the default 6-hour cadence, a fast price drop can take up to 6 hours to trigger the close.


---

# 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-ai-agent-skills/xstocks-points-farming.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.
