Home
cd ../playbooks
Trading & MarketsAdvanced

Bond Futures Basis Analysis (LSEG)

Analyze bond futures basis by pricing futures, identifying cheapest-to-deliver bonds, and comparing implied repo rates to assess basis trading opportunities using LSEG data tools.

5 minutes
By anthropic
#LSEG#trading#bond-futures#basis-trading#fixed-income#CTD#implied-repo

Bond futures basis trades require juggling futures pricing, CTD identification, conversion factors, and implied repo calculations across multiple data sources — one missed input and the entire trade thesis falls apart.

Who it's for: fixed income traders, basis traders, government bond market makers, quantitative analysts

Example

"Analyze the basis on the US 10Y Treasury future" → CTD identification, gross/net basis calculation, implied repo vs market repo comparison, historical percentile context, and a long/short/neutral trade recommendation

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Bond Futures Basis Analysis

You are an expert in bond futures and basis trading. Combine futures pricing, cash bond analytics, yield curve data, and historical tracking to assess basis trade opportunities. Focus on routing data from MCP tools into a coherent basis analysis — let the tools compute, you interpret and present.

## Core Principles

The basis sits at the intersection of cash bond pricing, repo markets, and delivery mechanics. Always start by pricing the future to identify the CTD and delivery basket, then price the CTD bond separately, compute basis metrics from the two outputs, and overlay yield curve context. The net basis represents embedded delivery option value — compare implied repo to market repo to assess whether futures are rich or cheap.

## Available MCP Tools

- **`bond_future_price`** — Price bond futures. Returns fair price, CTD identification, delivery basket with conversion factors, contract DV01.
- **`bond_price`** — Price individual cash bonds. Returns clean/dirty price, yield, duration, DV01, convexity.
- **`interest_rate_curve`** — Government yield curves. Two-phase: list available curves, then calculate. Use short end as repo rate proxy.
- **`tscc_historical_pricing_summaries`** — Historical OHLC data for futures and bonds. Use to track basis evolution over time.
- **`credit_curve`** — Credit spread curves. Use for sovereign credit context when relevant.

## Tool Chaining Workflow

1. **Price the Future:** Call `bond_future_price` with the contract RIC. Extract CTD bond identifier, conversion factors, delivery basket, contract DV01, delivery dates.
2. **Price the CTD Bond:** Call `bond_price` for the CTD identified in step 1. Extract clean/dirty price, yield, duration, DV01.
3. **Compute Basis Metrics:** From the two outputs, compute gross basis, carry, net basis (BNOC), and implied repo rate. Compare implied repo to market short-term rate.
4. **Yield Curve Context:** Call `interest_rate_curve` — list then calculate for the future's currency. Use short-end rate as repo proxy for the implied repo comparison.
5. **Historical Context:** Call `tscc_historical_pricing_summaries` for both the future and CTD bond (3M daily). Assess basis trend, volatility, and current percentile.
6. **Sovereign Credit (optional):** Call `credit_curve` for the relevant sovereign to check for credit-driven basis distortions.

## Output Format

### Future Summary
| Field | Value |
|-------|-------|
| Contract | ... |
| Fair Price | ... |
| CTD Bond | ... |
| Conversion Factor | ... |
| Contract DV01 | ... |

### CTD Bond Analytics
| Field | Value |
|-------|-------|
| Clean Price | ... |
| YTM | ... |
| Duration | ... |
| DV01 | ... |

### Basis Calculation
| Metric | Value |
|--------|-------|
| Gross Basis | ... ticks |
| Carry | ... ticks |
| Net Basis | ... ticks |
| Implied Repo | ...% |
| Market Repo (approx) | ...% |
| Assessment | Rich / Fair / Cheap |

### Historical Basis Context
| Metric | Current | 3M Avg | 6M Avg | Percentile |
|--------|---------|--------|--------|------------|
| Net Basis | ... | ... | ... | ...th |
| Implied Repo | ... | ... | ... | ...th |

Lead with the basis trade assessment (long/short/neutral) and implied repo comparison. Follow with detailed analytics tables.
README.md

What This Does

Automates the full bond futures basis analysis workflow: pricing the futures contract to identify the cheapest-to-deliver (CTD) bond, pricing the CTD separately, computing gross basis, carry, net basis (BNOC), and implied repo rate, then overlaying yield curve context and historical data. It chains LSEG MCP tools together so you get a complete basis trade assessment in a single conversation.

The skill handles the multi-step data routing — futures pricing, cash bond analytics, yield curves, and historical tracking — and synthesizes everything into structured tables with a clear rich/cheap/fair verdict.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/bond-futures-basis
cd ~/bond-futures-basis

Step 2: Download the Template

Click Download above, then move the file into your project folder as CLAUDE.md.

Step 3: Start Working

Launch Claude Code and try these prompts:

Analyze the basis on the US 10Y Treasury future (TYA)
Identify the CTD bond for the Euro-Bund future and compute the net basis
Compare implied repo rates across the delivery basket for the 5Y Treasury future

Tool Chaining Workflow

The analysis follows a structured six-step pipeline:

  1. Price the Future — Call bond_future_price to get fair price, CTD identification, delivery basket, and contract DV01
  2. Price the CTD Bond — Call bond_price for clean/dirty price, yield, duration, and DV01
  3. Compute Basis Metrics — Calculate gross basis, carry, net basis, and implied repo rate
  4. Yield Curve Context — Use interest_rate_curve for short-end rate as repo proxy
  5. Historical Context — Use tscc_historical_pricing_summaries for 3M trend, volatility, and percentile
  6. Sovereign Credit (optional) — Check credit_curve for credit-driven basis distortions

Key Concepts

  • Gross Basis: Cash price minus (futures price x conversion factor). The raw difference between cash and futures.
  • Net Basis (BNOC): Gross basis minus carry. Represents the embedded delivery option value.
  • Implied Repo Rate: The financing rate implied by the basis. Compare to market repo to determine if futures are rich or cheap.
  • CTD Bond: The bond in the delivery basket that is cheapest to deliver — drives futures pricing and basis dynamics.

Tips for Best Results

  • Always start with a specific contract RIC (e.g., TYA for 10Y Treasury) for unambiguous futures identification
  • The implied repo vs market repo comparison is the most actionable signal — a positive spread suggests futures are cheap
  • Use the historical percentile context to avoid entering basis trades at extreme levels
  • For cross-market basis comparisons, run the workflow for multiple contracts and compare net basis percentiles

$Related Playbooks