# Hot Deals

The Hot Deals system automatically identifies listings that are priced significantly below the average market price, helping you find the best opportunities quickly.

### You’ll learn

* What a “Hot Deal” means.
* How baselines are built from catalogues.
* How to view and sort hot deals.
* How to interpret the score.

## What are Hot Deals?

Hot deals are listings that are priced **significantly below** the average market price for similar items. HiveFB calculates this automatically when you have catalogue baseline data.

### How It Works

{% stepper %}
{% step %}

### Catalogue Creates Baseline

* When you scrape a catalogue, HiveFB calculates average prices
* This becomes the baseline for comparison
* Different catalogues have different baselines
  {% endstep %}

{% step %}

### New Listings Compared

* When new listings are found, prices are compared to the baseline
* Statistical analysis determines if price is significantly low
* If below threshold, listing is flagged as a hot deal
  {% endstep %}

{% step %}

### Alerts Generated

* Hot deals automatically trigger alerts
* You're notified in both dashboard and main app
* Never miss an exceptional opportunity
  {% endstep %}
  {% endstepper %}

## Understanding Hot Deal Scores

Each hot deal receives a score from 1-10:

### Score Breakdown

**8-10: 🔥 Exceptional Deal**

* Rare and highly valuable
* Act quickly - these don't last long
* Significant savings opportunity
* Worth immediate investigation

**6-7: 👍 Good Deal**

* Above average savings
* Worth investigating
* Good value for money
* Solid opportunity

**4-5: ⚠️ Fair Deal**

* Slightly below average
* May be average pricing
* Worth checking but not urgent
* Could be normal variation

**1-3: ❌ Poor Deal**

* May be incorrectly flagged
* Could indicate data issues
* Review carefully
* May not actually be a deal

## Viewing Hot Deals

### In the Dashboard

{% stepper %}
{% step %}

### Navigate to Hot Deals

* Click "🔥 Hot Deals" in the top navigation
* Hot Deals page opens

{% hint style="info" %}
**Screenshot placeholder:** Dashboard navigation with “Hot Deals” selected.
{% endhint %}
{% endstep %}

{% step %}

### View All Hot Deals

* See all hot deals in card format
* Each card shows:
  * Original listing with all details
  * Percentage below average
  * Which catalogue detected it
  * When the alert was created
  * Hot deal score
    {% endstep %}

{% step %}

### Sorting Options

* **% Below**: Sort by discount percentage (highest first)
* **Recent**: Sort by when alert was created
* **Time Listed**: Sort by when listing was posted on Facebook
  {% endstep %}

{% step %}

### View Details

* Click any hot deal card
* Opens full listing details modal
* See all information and images
* Link to view on Facebook

{% hint style="info" %}
**Screenshot placeholder:** A hot deal card + the details modal showing % below and score.
{% endhint %}
{% endstep %}
{% endstepper %}

### In the Main App

{% stepper %}
{% step %}

### Open Alerts

* Click "🔔 Alerts" in the sidebar
* Alerts modal opens

{% hint style="info" %}
**Screenshot placeholder:** Main app Alerts modal showing at least one hot deal (hide personal info).
{% endhint %}
{% endstep %}

{% step %}

### View Hot Deals

* Hot deals appear in the alerts list
* Same information as dashboard
* Quick access without opening dashboard
  {% endstep %}

{% step %}

### Sorting

* Same sorting options available
* "Newest Listed" and "Oldest Listed" options
* Sort by percentage below average
  {% endstep %}
  {% endstepper %}

## Hot Deal Information

### What You'll See

**Listing Card:**

* Full listing image
* Title and description
* Current price (highlighted)
* Location
* Time listed

**Hot Deal Details:**

* **Percentage Below**: How much below average (e.g., "23% below")
* **Catalogue Source**: Which catalogue detected this
* **Alert Created**: When the hot deal was identified
* **Hot Deal Score**: 1-10 rating
* **Average Price**: What similar items typically cost

### Example Hot Deal

```
🔥 Hot Deal - Score: 9/10
2018 Honda Civic LX
Price: $12,500
Average: $16,200
23% Below Average

Detected by: "Honda Civics" catalogue
Alert Created: 2 hours ago
Listed: 1 day ago
```

## How Hot Deals Are Calculated

### Statistical Analysis

{% stepper %}
{% step %}

### Baseline Calculation

* Collects prices from catalogue scrapes
* Calculates mean (average) price
* Determines standard deviation
* Establishes price distribution
  {% endstep %}

{% step %}

### Comparison

* New listing price compared to baseline
* Calculates percentage difference
* Applies statistical thresholds
* Flags if significantly below
  {% endstep %}

{% step %}

### Score Assignment

* Based on how far below average
* Considers price distribution
* Accounts for market variations
* Assigns 1-10 score
  {% endstep %}
  {% endstepper %}

### Requirements

**To Get Hot Deals:**

* Must have scraped catalogue data first
* Catalogue must have sufficient listings (10+ recommended)
* New listings compared to catalogue baseline
* Price must be statistically significant below average

{% hint style="info" %}
No baseline means no hot deals. Scrape catalogues first.
{% endhint %}

<details>

<summary><strong>Why No Hot Deals?</strong></summary>

* Haven't scraped any catalogues yet
* Catalogue has too few listings
* No new listings found since catalogue scrape
* Prices are all around average

</details>

## Best Practices

{% stepper %}
{% step %}

### Build Good Baselines

* Scrape catalogues with 100+ listings
* Let catalogues complete fully
* Use specific search terms
* Update catalogues regularly
  {% endstep %}

{% step %}

### Monitor Regularly

* Check hot deals daily
* Sort by "Recent" to see newest
* Act quickly on high scores (8-10)
* Investigate before they're gone
  {% endstep %}

{% step %}

### Use Multiple Catalogues

* Create catalogues for different vehicle types
* Each catalogue creates its own baseline
* More catalogues = more hot deal opportunities
* Cover different price ranges
  {% endstep %}

{% step %}

### Verify Hot Deals

* Check listing details carefully
* Verify condition and mileage
* Compare to similar listings
* Consider seller reputation
  {% endstep %}
  {% endstepper %}

## Hot Deal Alerts

### Notification System

**When Alerts Trigger:**

* New hot deal detected
* Score 6 or higher (configurable)
* Immediately after detection

**Where You're Notified:**

* Dashboard notifications page
* Main app alerts modal
* Notification badge in navigation

**Alert Information:**

* Listing title and price
* Percentage below average
* Hot deal score
* Link to view details

### Managing Alerts

* **Mark as Read**: Clear individual alerts
* **Mark All Read**: Clear all at once
* **Delete**: Remove alerts you've seen
* **Filter**: Show only hot deal alerts


---

# 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.hivefb.app/core-workflow/hot-deals.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.