<WRAP center round important 60%>
**Note:** This addon relies entirely on market data provided by [[https://universalis.app/|Universalis]].  
If Universalis is unavailable or missing data for your server, results may be incomplete or outdated.
</WRAP>


====== Cypher Market Analysis (CMA) ======

Cypher Market Analysis (CMA) is a market board helper for FFXIV. It pulls live Universalis data and gives you:

  * Quick lookups (by item or inventory)
  * Profit & demand insights
  * Sub-material cost breakdowns
  * A one-off price checker per world
  * Automation for buying items (Requires Madao Plus) – Enable in MadaoCore [[https://imgur.com/wL88sCK|here]].

===== Automated Buying =====
CMA doesn’t just show prices — it can actually **buy items for you**.

  * Pick servers, add items to your **Shop List**, and set:
    * Max price
    * Stack size
    * Quality (Any/HQ/NQ)
  * The addon finds the cheapest matching listings:
    * **Candidates**
    * **Snipes**
    * **Arbitrage**
  * From here you can:
    * **Add to Cart** (stage)
    * **Queue** (buy now)
  * **Queued items** become **Tasks**:
    * Each task = buy job with item, price, qty, server, and quality.
  * The runner (**Madao Plus**) executes tasks:
    * Travels to the right server
    * Buys the item if it matches your rules
    * Reports success/fail
  * Finished purchases are logged in **History**.


===== Market =====
  * Add items to your Shop List.
  * Set your max price, min price (optional), max stack size, and quality (Any/HQ/NQ).
  * Pick which servers to search.
  * (Optional) One click to add a craft’s materials to your cart at the cheapest prices.
{{:market.png?800|}}
===== Candidates =====
  * Shows the cheapest matching listings from your selected servers for items on your Shop List.
  * From here you can **Add to Cart** or **Queue** a buy right away.
{{:candi.png?800|}}
===== Arbitrage =====
  * Finds items that are cheaper on other servers than your home server.
  * Shows profit per unit and margin %; you can filter by margin and quality.
  * Optionally auto-queue good rows, with a per-item units cap.
{{:arbi.png?800|}}
===== Snipe =====
  * Set a target item, max price, max stack size, and how many to grab.
  * When a match appears, it can auto-queue (or you can press **Run** to check now).
{{:snipe.png?800|}}
===== Cart =====
  * Holds the listings you’ve chosen to buy (your shopping cart).
  * You can change the buy quality, remove items, clear, save, load, or **Queue All** to start buying.
{{:cart.png?800|}}
===== Tasks =====
  * Shows all buy jobs (queued purchases) with their status (Pending, Claimed, Success, etc.).
  * You can claim, renew, mark success/fail, unclaim, cancel, or delete tasks.
{{:tasks.png?800|}}
===== History =====
  * A log of your past purchases (time, item, price, qty, total).
  * Includes simple stats (min/median/avg/max) per item and server.
{{:history.png?800|}}
===== Search by Item =====
**Purpose:** fetch and analyze a single item quickly.

  * **Input**: ID or name (type ≥2 letters for suggestions).
  * **Fetch**: primary world (your current world) queues other selected worlds.
  * **Analyze**: recompute metrics on fetched primaries.
{{:itemsearch.png?800|}}
**Market Data panel**

  * Per-item “Market Summary” (min/avg/max, listings, 7d sales).
  * Per-server details (top listings, recent sales, stale tag).
  * HQ/NQ-only summaries when a quality filter is chosen.

===== Inventory Scan =====
**Purpose:** pull market data for items you actually own.

  * Toggle which containers/slots to scan (bags, gear, shards, etc).
  * Tick items → **Fetch** to add as primary items.
  * Uses the same Market Data view as above.
{{:inventory.png?800|}}
===== Item Insights =====
**Purpose:** profit, margin, demand, and “Top 5”.

**Actions**
  * **Analyze**: recompute across all primary items.
  * **Export**: copies a CSV snapshot to clipboard.
===== Profit Analysis Settings =====
  * how many recent sales to average.
  * window for demand/velocity.
  * score if no sales in window.

===== Filters & Display =====
  * Quality: **All | NQ | HQ**
  * Velocity gate: **AUTO** (≈ ≥1/wk when window ≥7) | **DAY** | **WEEK**
  * “Only craftable”, “Only if all sub-mat prices known”
  * Toggle Sales/Week column, include zero-sales rows
  * Name filter (substring)
  * Server focus selector

===== Tables =====
  * **Comprehensive**: Item, ID, Avg, Craft Cost, Profit (craft), Margin %, Sales/Day or /Week
  * **Top 5 by Combined Score**
  * **Arbitrage** (optional panel): shows worlds with largest price deltas for each item.
{{:insights.png?800|}}
===== Material Breakdown =====
**Purpose:** recipe-aware costs & per-ingredient price sanity.

  * Click **Analyze All Items (Including Sub Mats)** once.
  * Filters: only profitable, require all sub-prices, min unit profit, min margin %.

**Per-item panel:**
  * Key metrics (avg, unit cost, unit profit, margin %, sales/day, score)
  * Recipe table with cheapest per-ingredient price (honors focus worlds)

**Auto-fetch sub-materials**
  * when you fetch a primary item, queue its ingredients.
  * recurse into ingredients of ingredients.
{{:breakdowns.png?800|}}
===== Price Checker =====
**Purpose:** one-off price view for a specific world.

  * Pick DC and Server, type an item, click **Check**.
  * Shows min/avg/max, top listings, recent sales.
  * Marks data **[stale]** after TTL.
{{:checkerprice.png?800|}}
====== WatchList ======

===== What it does =====
  * Lets you add items to a watchlist and pick which servers (worlds) to monitor.
  * Regularly pulls Market Board data from Universalis (prices + recent sales).
  * Shows quick popups for Top Listings and Recent Sales per server.

===== Alerts & flags =====
  * **Undercut**: flags when the lowest listing drops below your set Min Price.
  * **Price Drop / “Snipe”**: flags big sudden drops (configurable %/amount & cooldown).
  * **High Price (optional)**: notifies when price exceeds a threshold.

===== Quality-of-life =====
  * Auto-clears old or rebounded snipe flags.
  * Can auto-remove items that have no sales for X days.
  * Keeps per-server stats (last price, highs/lows, sales, undercut counts).

===== Basics to use =====
  * Add an item by name/ID, set min/max price and (optionally) a retainer filter.
  * Pick servers in your current data center.
  * Let it run; it updates every N seconds (≥30) in the background.
{{:watchlist.png?800|}}

===== Madao Sell (Auto Pricing) =====
**Purpose:** automatically refresh and write list prices to your `MarketSell` file using Universalis data. This does not list/sell items, it only updates your prices.

**How it works**
  * Load a MarketSell file name (e.g., `Default.lua`).
  * Add items via search/suggestions and set Qty each (caps stack sizes considered in pricing).
  * Choose Quality (All/HQ/NQ) and a Strategy.
  * Click Run update now or enable Auto-update every X minutes.
  * Review the table: Ask (current), >Ask (proposed), Floor toggle Apply per row.
  * Press Save file to write prices back to your `MarketSell` file.

**Strategies**
  * **Smart+** – Ignores weird outliers undercuts the real low cluster.
  * **Dynamic** – Undercuts today’s cheapest, scaled by market activity.
  * **History** – Prices from recent **sold** averages, not noisy listings.
  * **Flat** – Fixed-amount undercut (simple & predictable).

**Guards & Rounding**
  * Floor/Ceiling guards prevent tanking or overpricing.
  * Prices are rounded to sensible ticks.

**Notes**
  * Requires Universalis availability.
{{:madaoselllist.png?800|}}