ADDENDUM: Actionable Edge Mapping + Prediction Market Ladder

Futures Desk — MERGED FINAL

Base: Claude Opus 4.6 | Panel additions from: Gemini Pro, Grok 4.1 Fast

GPT-4.1 excluded (off-desk drift — weather/BTC examples not futures-relevant). DeepSeek V3 excluded (submitted sports desk content).

This addendum supplements the original Futures Desk spec. It does NOT replace the existing spec — it adds two critical layers: (1) mapping every edge to a specific trade on a specific platform, and (2) a systematic methodology for scanning prediction market ladders for futures-relevant contracts.

TOPIC 1: ACTIONABLE EDGE OUTPUT

1. Edge-to-Trade Mapping Table

2. Actionable Output Format

JSON output sent via Telegram and to other desks:

{
  "edge_id": "FUTURES-20260315-CL-EIA-001",
  "desk": "futures",
  "timestamp": "2026-03-15T10:35:00Z",
  "edge_description": "EIA petroleum report: -5.2M barrel draw vs -1.5M consensus. Massive bullish surprise. Kalshi and Polymarket crude oil contracts underpriced.",
  "signal_type": "eia_inventory_surprise",
  "commodity": "Crude Oil (WTI)",
  "event": "EIA Weekly Petroleum Report, released 10:30 AM ET",
  "surprise_magnitude": "-3.7M barrels vs consensus (2.5x expected draw)",
  "confidence_level": 85,
  "conviction_score": {
    "data_quality": 95,
    "source_agreement": 80,
    "temporal_relevance": 100,
    "market_positioning": 75,
    "historical_pattern": 82,
    "edge_size": 88,
    "composite": 85
  },
  "platforms": {
    "Kalshi": {
      "mispriced_contracts": [
        {
          "contract": "Crude oil above $82 (weekly close)",
          "current_price": 35,
          "fair_value": 48,
          "edge_cents": 13,
          "edge_after_fees": 11,
          "action": "Buy YES at 35c",
          "liquidity_usd": 500
        },
        {
          "contract": "Crude oil above $84 (weekly close)",
          "current_price": 18,
          "fair_value": 28,
          "edge_cents": 10,
          "edge_after_fees": 8,
          "action": "Buy YES at 18c",
          "liquidity_usd": 300
        }
      ]
    },
    "Polymarket": {
      "mispriced_contracts": [
        {
          "contract": "WTI Crude Oil above $82 (weekly)",
          "current_price": 33,
          "fair_value": 48,
          "edge_cents": 15,
          "edge_after_fees": 13,
          "action": "Buy YES at 33c",
          "liquidity_usd": 250,
          "note": "Check for cross-platform divergence vs Kalshi — take the better price"
        }
      ]
    },
    "Futures_Broker": {
      "action": "Long CL (crude oil) front month futures",
      "current_price": 80.50,
      "target": 83.50,
      "stop": 79.00,
      "risk_reward": "2.0:1",
      "margin_required_usd": 6500,
      "note": "Or long USO (oil ETF) if no futures account"
    }
  },
  "time_sensitivity": "HIGH — post-EIA momentum typically fades within 4-6 hours. Trade Kalshi and Polymarket immediately. Futures position can be held 1-3 days.",
  "cross_desk_alerts": {
    "forex": "Bullish crude → CAD strength → short USD/CAD on OANDA",
    "stocks": "Bullish crude → energy sector strength → long XLE",
    "crypto": "Bullish crude → risk-on → mild BTC tailwind"
  },
  "risk_factors": ["SPR release announcement could offset", "OPEC meeting in 2 weeks could change supply outlook", "Demand concerns if GDP weakens"]
}

Telegram summary format:

FUTURES EDGE: Crude Oil — EIA Surprise

Draw: -5.2M barrels vs -1.5M consensus (MASSIVE)

Kalshi:
  CL above $82 @ 35c | Fair 48c | Edge 13c | Buy YES | $500 liq
  CL above $84 @ 18c | Fair 28c | Edge 10c | Buy YES | $300 liq

Polymarket:
  CL above $82 @ 33c | Fair 48c | Edge 15c | Buy YES | $250 liq
  (Check cross-platform — take best price between Kalshi and Polymarket)

Futures: Long CL @ $80.50 | Stop $79.00 | Target $83.50

Cross-desk: Short USD/CAD (forex), Long XLE (stocks)
Conviction: 85/100 | Window: 4-6 hours

3. Platform Priority Ranking

TOPIC 2: PREDICTION MARKET LADDER STRUCTURE

1. Desk Data Mapping to Prediction Market Contracts

Note on Kalshi vs Polymarket parity: Both platforms operate independent ladder structures across multiple contracts at different thresholds for the same underlying events. Neither is a fallback for the other — both are primary scan targets. The desk will pull both simultaneously and compare prices at each rung. Divergences between Kalshi and Polymarket at the same threshold represent a cross-platform arbitrage opportunity and should be flagged separately.

2. Sharp Reference Identification

3. Probability Curve Construction Method

For commodity price contracts:

• Distribution: Log-normal with mean-reversion overlay. Commodity prices are not pure random walks — they mean-revert to production costs over long horizons but trend over short horizons.
• Short-term (1-7 days): Log-normal with volatility calibrated to the options-implied volatility (IV) of the at-the-money option on the front-month futures contract. [PANEL: Gemini Pro] This is the correct institutional approach: options-implied vol is forward-looking and reflects the market's current expectation of realized vol over the contract horizon. Historical realized vol is a fallback when options data is unavailable, but IV is preferred — it reflects what the options market (which is sharper than the prediction market) expects, not what happened in the past. For crude oil: pull IV from CME CL options (front-month ATM strike). For gold: pull IV from CME GC options. For natgas: pull IV from CME NG options.
• Mean: Current futures price adjusted for daily drift (carry from the term structure).
• Medium-term (1-4 weeks): Add seasonal adjustment. E.g., natural gas has strong seasonality (heating demand Nov-Mar, cooling demand Jun-Aug). Shift the mean by the historical seasonal average return for the current calendar period.
• Term structure information: If the futures curve is in steep backwardation, the market expects prices to fall over time. Adjust the mean downward for contracts further out.

For economic data contracts (CPI, NFP, GDP):

• Normal distribution, centered on the desk's weighted point estimate.
• SD from historical forecast errors. The Futures Desk has ADDITIONAL inputs (ISM sub-components, commodity prices, yield curve signals) that other desks don't track as closely — these narrow the SD and improve point estimate accuracy.

For rate decision contracts:

• Discrete probabilities from CME FedWatch.
• Adjust for: recent Fed speaker statements (hawkish/dovish shift not yet reflected in FedWatch), COT positioning in rate futures (extreme positioning suggests vulnerability to surprise), and credit spreads (widening spreads = financial stress = more likely cut).

Honest gap call — calendar spreads: [PANEL: Gemini Pro] Calendar spreads (long front month / short deferred, or the reverse) have no good prediction market equivalent on either Kalshi or Polymarket. Both platforms focus on absolute price levels at a single point in time, not the relationship between two contract months. This is a genuine structural gap. Calendar spread edges belong exclusively in the futures broker venue and should not be forced onto a prediction market ladder. Document this limitation in edge output JSON when a calendar spread is the primary signal.

Historical data feeding the model:

• 5+ years of daily commodity futures prices (from Polygon.io once subscribed, or FRED for spot prices).
• 5 years of CPI/NFP/GDP actual vs consensus (from FRED + Investing.com calendar archive).
• Seasonal patterns: calculate average monthly returns for each commodity over 10-20 years.
• COT historical positioning: build percentile ranks for each commodity.

Recalculation frequency:

• Commodity prices: Every hour during US market hours. Immediately after EIA/WASDE releases. Recalculate IV inputs on the same cadence as price — IV moves when the underlying moves.
• Economic data: Daily until T-3, then every 6 hours.
• Rate decisions: Weekly, or immediately after Fed speakers or major data.

4. Ladder Scanning Methodology

Step-by-step process:

1. Pull all active contracts: Kalshi API for CPI, NFP, GDP, Fed rate, crude oil, natgas, gold, yields, unemployment. Polymarket for all overlapping economic, macro, and commodity contracts. Both platforms are scanned simultaneously — not sequentially.

2. Group by category and identify the sharp reference for each:

   • Commodity contracts → options-implied vol (IV) from CME options on the underlying future + futures curve + seasonal. [PANEL: Gemini Pro]
   • Economic data → nowcast models + consensus + desk point estimate.
   • Rate decisions → FedWatch probabilities.
   • Commodity tails → cross-reference Deribit perps as vig-free tail calibrator. [PANEL: Grok 4.1 Fast]

3. For each contract threshold, calculate fair probability:

   • Commodity: P(CL > $82 by Friday) using log-normal CDF with IV-derived vol and current price.
   • Economic: P(CPI > 3.4%) using Normal CDF with desk estimate and historical error SD.
   • Rate: FedWatch probability directly (discrete).

4. Calculate raw edge: |fair_probability - contract_price|.

5. Apply conviction score overlay: Use the 6-component conviction scoring framework from the main spec:

   • Data quality (is the sharp reference from a government source? → high quality).
   • Source agreement (do multiple indicators agree?).
   • Temporal relevance (is this data fresh or stale?).
   • Market positioning (COT extreme? → amplifies surprise).
   • Historical pattern match (seasonal alignment? → boosts confidence).
   • Edge size (bigger edge = higher conviction).

6. Net edge after fees: Subtract 1.5c for Kalshi. Apply appropriate fee for Polymarket (typically higher gas/transaction cost on crypto-settled markets — account for this in net edge calculation).

7. Filter: Minimum 3c net edge, minimum $50 liquidity, conviction score >55.

8. Cross-platform comparison: For any threshold where both Kalshi and Polymarket have a contract, flag the price difference. If Kalshi has "CPI above 3.4%" at 18c and Polymarket has the same at 22c, note both. Take the better-priced entry. If the divergence is large (>5c on the same underlying), flag as cross-platform arbitrage opportunity.

9. Rank: Sort by net_edge * conviction_score / 100. Top 5 go to Telegram alert.

10. Flag special situations:

    • "EVENT IMMINENT" for contracts settling within 24 hours (CPI/NFP/GDP release day).
    • "SEASONAL ALIGNMENT" for commodity contracts where the seasonal pattern supports the edge.
    • "POSITIONING EXTREME" for contracts where COT is at >90th percentile extreme.
    • "CALENDAR SPREAD ONLY" for term structure signals with no prediction market equivalent — route exclusively to futures broker. [PANEL: Gemini Pro]
    • "CROSS-PLATFORM DIVERGENCE" when Kalshi and Polymarket price the same threshold more than 5c apart.

5. Edge Examples with Real Numbers

Example 1: CPI Ladder — Cleveland Fed Nowcast Divergence

• Context: CPI releasing tomorrow, March 16, at 8:30 AM ET.
• Consensus (Investing.com): 3.2% y/y headline CPI.
• Cleveland Fed Nowcast: 3.38% (running hot, driven by sticky shelter + energy rebound).
• Futures desk point estimate: 0.6 * 3.38 + 0.4 * 3.2 = 3.33%.
• SD: 0.11% (5-year historical forecast error).
• Kalshi ladder:
  • "CPI above 3.2%": 52c. Fair: P(N(3.33, 0.11) > 3.2) = P(Z > -1.18) = 88.1%. Edge = 36c. Huge, but the main line is efficiently priced usually — double-check this.
  • "CPI above 3.4%": 18c. Fair: P(Z > (3.4-3.33)/0.11) = P(Z > 0.636) = 26.2%. Edge = 8.2c (6.7c net). Tradeable.
  • "CPI above 3.6%": 5c. Fair: P(Z > (3.6-3.33)/0.11) = P(Z > 2.45) = 0.7%. Edge = 5% - 0.7% = 4.3c (2.8c net). Marginal but interesting on the NO side: buy NO at 95c, fair NO value 99.3c, net edge 2.8c.
• Polymarket check: Pull "CPI above 3.4%" equivalent. If Polymarket prices it at 14c vs Kalshi's 18c, take Polymarket (larger edge). If Polymarket prices it at 20c, take Kalshi. Always compare both.
• Best trade: Buy YES on "CPI above 3.4%" at whichever platform prices it lower. Edge 8.2c gross. Conviction is high because the Cleveland Fed Nowcast is the best free CPI predictor and it's running 0.18% above consensus.
• Cross-desk: Alert Forex desk (hot CPI → USD strength), alert Stocks desk (hot CPI → sell SPY).

Example 2: Natural Gas — Seasonal + EIA Storage Surprise

• Context: Late November 2026. Natural gas entering peak heating demand season.
• Current NG price: $3.15/MMBtu.
• EIA storage report (just released): -98 Bcf draw vs -72 Bcf consensus. Larger draw = colder weather depleting storage faster.
• Seasonal pattern: Nov-Jan natgas averages +18% return (10-year average). Current year: La Nina pattern = colder-than-normal winter expected.
• Vol input: Pull IV from CME NG front-month ATM options. Assume IV = 55% annualized (typical for natgas in Nov). Weekly SD = 55% * sqrt(5/252) = 7.75% → ~$0.244. (Note: this IV-derived vol is higher than a 20-day realized vol calculation would give — the options market is pricing in the seasonal demand uncertainty. This is why IV is preferred over historical vol here.) [PANEL: Gemini Pro]
• Kalshi rung: "Natgas above $3.50" (end of December, ~4 weeks out) at 22c.
• Fair probability:
  • Base log-normal using IV-derived 4-week vol: SD = 55% * sqrt(30/252) ≈ 19% of price → ~$0.60. P(LN > 3.50 | mean=3.15, SD=0.60) using log-normal: approximately 29%.
  • Seasonal adjustment: +18% historical mean in this window. Adjust mean to 3.15 * 1.09 (conservative half) = $3.43.
  • Adjusted: P(NG > 3.50) with adjusted mean ≈ 43%.
  • EIA surprise overlay: large draw boosts bullish case. Add 5% → 45%.
• Deribit perp check: Pull Deribit NG perp pricing for $3.50 tail. If Deribit implies 40% at this threshold, that confirms the 45% fair value is in the right zone. [PANEL: Grok 4.1 Fast]
• Raw edge: 45% - 22% = 23 cents
• Net edge: 23 - 1.5 = 21.5 cents
• Polymarket check: Pull Polymarket natgas equivalent. Compare price. Take the cheaper entry between Kalshi and Polymarket.
• Trade: Buy YES on "Natgas above $3.50" (Dec expiry) at 22c on whichever platform is cheaper.

Example 3: Fed Rate Decision — FedWatch Divergence

• Context: FOMC meeting next week. March 2026.
• CME FedWatch: Hold 65%, Cut 25bp 35%.
• Kalshi contract: "Fed cuts rate in March" at 25c (implied 25%).
• Polymarket contract: "Fed cuts in March" at 27c (check for cross-platform divergence).
• Futures desk analysis: SOFR futures are pricing slightly more dovish than FedWatch headline (SOFR implies 38% cut probability). Recent Beige Book showed 4 of 12 districts reporting weakening demand. ISM Services employment sub-index dropped below 50 (contraction). Initial claims ticking up to 235K (4-week MA).
• Desk fair probability of cut: Weighted: FedWatch 35% + SOFR-implied 38% + desk macro overlay (weakening data supports cut) = 37%.
• Kalshi: Raw edge = 37% - 25% = 12 cents. Net = 10.5 cents.
• Polymarket: Raw edge = 37% - 27% = 10 cents. Net lower after gas fees. Take Kalshi here.
• Cross-platform note: Both platforms are priced below fair value. Kalshi is better priced. Take Kalshi. Flag the Polymarket discrepancy as confirmation (both are independently underpricing the cut probability).
• Cross-desk: Alert Forex desk (rate cut = USD weakness = long EUR/USD). Alert Stocks desk (rate cut = bullish equities).

IMPORTANT NOTES

• The Futures Desk is the MACRO INTELLIGENCE CENTER. Its analysis of CPI, NFP, GDP, Fed rates, and commodity supply/demand directly feeds Kalshi and Polymarket trading across multiple desks.
• Economic data contracts on Kalshi and Polymarket are this desk's highest-value prediction market opportunity. The desk has unique access to government data sources (EIA, USDA, BLS, Fed) that provide genuinely sharp references.
• Kalshi and Polymarket are co-equal primary platforms. Both run independent ladder structures with multiple contracts at different thresholds for the same underlying events. Always scan both. Never treat one as a backup for the other. Cross-platform price divergences are themselves tradeable signals.
• Use options-implied volatility (IV) as the primary SD calibrator for commodity price distributions. [PANEL: Gemini Pro] Historical realized vol is a fallback only. IV from CME options on the underlying future is the institutionally correct approach — it is forward-looking and reflects the current market consensus on expected move magnitude.
• Deribit perpetuals serve as a vig-free sharp reference for commodity tail probability calibration. [PANEL: Grok 4.1 Fast] When Kalshi or Polymarket prices a far-tail commodity rung, cross-reference Deribit perp pricing to sanity-check the fair probability estimate. Deribit's lack of built-in vig makes it cleaner than exchange-quoted options for this purpose.
• Calendar spreads have no prediction market equivalent — this is an honest structural gap. [PANEL: Gemini Pro] Kalshi and Polymarket price absolute levels at a single point in time. They cannot express the relationship between contract months. All calendar spread edges route exclusively to the futures broker. Do not attempt to approximate a calendar spread edge on a prediction market ladder.
• Always cross-reference commodity Kalshi and Polymarket contracts with the term structure. If the futures curve is in steep contango (market expects lower prices), tail YES contracts are even more overpriced.
• COT positioning is a CONFIDENCE AMPLIFIER, not a standalone signal. Use it to size positions, not to initiate them.
• The conviction scoring framework from the main spec should be applied to every Kalshi and Polymarket trade. Minimum conviction 55 for entry.
• Atlanta Fed GDPNow is the single most valuable free tool for GDP contract pricing on both Kalshi and Polymarket. Update your GDP fair value every day it updates.
• Cross-desk output is critical: every EIA, WASDE, CPI, NFP surprise should generate alerts to Forex, Stocks, Crypto, and Options desks with directional implications.