> For the complete documentation index, see [llms.txt](https://jester.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jester.gitbook.io/docs/tools/oracle.md).

# Oracle

**Bot:** <https://t.me/jesterStatsBot>

#### **Important Notes**

1. **Registration via Castellan:** You must **first register** through our **Castellan user management bot** before using Oracle. Castellan handles all user access permissions and ties directly into Oracle.
2. **Premium Feature:** At this time, **uploading new backtests** (CSV files) to Oracle is **reserved for Premium tier** users. Basic-tier users can view limited reports or previously processed data.
3. **How Our Parser Works:** Our CSV parser reads the exported TradingView data row by row, identifying when trades start and end based on pivot and trend signals. It then calculates your trade outcomes (win, loss, partial targets, etc.) along with advanced metrics. This data is stored as new CSV files in the backend, which can later be aggregated or used to train our **Jester ML models**.

{% hint style="success" %}
&#x20;**Oracle** is uniqu&#x65;**,** as we also simulates real-world conditions—including **random slippage**, **maker/taker fees**, and **partial take profit exits**—to give you **results closer to a live trading environment**.
{% endhint %}

## Steps to Get Started

### 1. **Register with Castellan**

1. Open our [Castellan](/docs/tools/castellan.md) user management bot.
2. Complete the verification process.
3. Input your TradingView ID.

> ![](/files/Oj8yamVpT2WfC8KmxNRz)

### 2. **Launch the Jester TV Indicator**

1. Make sure you are **using Jester | Infinity v.02 or later** on TradingView for full compatibility.
2. Install or update the script if you haven’t already, accessible automatically via Castellan.
3. The script can be found inside the "Invite-only" section in Indicators.

   ![](/files/kw2tXO1pCvvMnwMXyQmn)

### 3. **Prepare Your Chart**

1. Navigate to the chart (trading pair) you want to analyze in TradingView.
2. In your Jester indicator settings:

   * **Enable Backtest Mode** in the **Input** tab, and select the start date you want to backtest from.

   <figure><img src="/files/7POxduEqz3vVaqabPm4C" alt=""><figcaption></figcaption></figure>

   * In the **Style** tab, \**enable all “**Backtest:** ” plots* (such as “**Backtest: Entry Price**,” “**Backtest: Trade ID**,” etc.) to include those columns in the exported CSV.&#x20;

     <figure><img src="/files/y0opXs38PpbyN7pevwDS" alt="" width="259"><figcaption></figcaption></figure>
   * Also in **Style,** ensure **"Stop Plot", "Profit 1 Plot",** and **"Profit 2 Plot"** are enable&#x64;**.**

   <figure><img src="/files/bBUdzBIdkhezVsolPD30" alt=""><figcaption></figcaption></figure>
3. Double-check that your Jester indicator is still using the **default style** for everything else to ensure consistent results.

### 4. **Export Your Chart Data**

1. Go to **Layout** → **Export chart data** in TradingView. Ensure **UNIX is selected as the timestamp.**

   <figure><img src="/files/mFfgLtkKxYW842FWZUXP" alt="" width="270"><figcaption></figcaption></figure>
2. Use the **default naming format** (e.g., `BITSTAMPBTCUSD, 58e33e.csv`) so our parser can better auto-detect the market data.

   <figure><img src="/files/sMQ7eg8i4CIFNMjOqJih" alt=""><figcaption></figcaption></figure>
3. *Note:* At present, **uploading new backtests** requires **Premium** access.
4. After exporting, **download the CSV file** to your device.
5. **You’re now ready to take advantage of Oracle’s analytics!**

> ![](/files/meCep7jDRAuOVh6Frk6p)

### **5. Open Oracle & Configure Your Settings**

1. **Open** **Oracle** and type or use the **`/start`** command.

   <figure><img src="/files/dyFGnTWlMtog8osYEwKd" alt=""><figcaption></figcaption></figure>
2. Since you’re already registered with **Castellan**, your user data will **auto-sync** into Oracle.
3. Oracle will prompt you to set your **account details**:
   * **Account Size**: Your starting capital.
   * **Risk Amount**: The percentage or amount you’re risking per trade.
   * **Maker/Taker Fees**: Define the fee rates for your trading platform.
   * **Split Take Profit**: If you prefer partial exits (like TP1/TP2), set how you want trades allocated.
4. Once saved, these **defaults** will apply to **all future** backtest calculations until you change them.

   <figure><img src="/files/Q351LEIIAtQAnqgVIseX" alt=""><figcaption></figcaption></figure>

### **6. Add or View Backtests**

1. If you’re a **Premium** user, you can **upload** a new CSV by using the **`New Backtest`** button.
2. If you’re a **Basic** user, you can still **view existing** test results but won’t be able to upload new ones.
3. Upon uploading, Oracle’s **parser** automatically:
   * Reads trade signals.
   * Determines trade entries and exits.
   * Calculates trade stats (P/L, fees, partial profits, etc.).
   * Generates CSV output for further analysis or ML training.

     <figure><img src="/files/Xp8m3UCvJOP9uHiSUTlE" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Oracle tries to simulate as close to a real trading environment as possible, this includes maker taker fees, position sizing, and even randomized slippage. However backtests do **NOT** equal real results, as always, trading is a risky business, and you can lose. Never invest more than you can afford to lose.
{% endhint %}

### **After Parsing**

* You’ll receive **summary CSV files** and aggregated metrics.

  <figure><img src="/files/svsBGZ26TUqH0c6iudTj" alt=""><figcaption></figcaption></figure>
* If you’re on Premium tier, these backtests can be used to enhance your **personal trading insights** and feed data into Jester’s ongoing **machine learning** efforts.

### **That’s It!**

* Make sure you’re registered with **Castellan** so **Oracle** recognizes your **access level**.
* If you’re in Premium tier, get ready to **upload** and **parse** new backtests.
* Ensure your CSV names are the default exported from TradingView.&#x20;
  * Example: \<BROKER>\_\<PAIR>, \<TIMEFRAME>\_\<ID>.csv
* Enjoy deeper insights with Oracle’s **advanced parsing**, and let us know if you have any questions!

**Need Help?**\
Contact support in our [**Telegram Support**](https://t.me/+5zPvmtbk7WE5YTE5) group, or reach out to the **team** directly.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://jester.gitbook.io/docs/tools/oracle.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.