Equity · Global · futures · Monthly Free

Commodity Futures Roll-Return Strategy

Academic paper

Tactical Allocation in Commodity Futures Markets: Combining Momentum and Term Structure Signals

AuthorsAna-Marı́a Fuertes; Joëlle Miffre; Georgios Rallis

Institute

City, University of London
Bayes Business School, City, University of London
Audencia Business School
City University of London - Sir John Cass Business School

Paper linkhttps://papers.ssrn.com/sol3/papers.cfm?abstract_id=1127213

Screenshot from the original paper

Strategy in a nutshell

Each month, this straightforward strategy invests in the top 20% of commodities showing the highest roll-returns, while short selling the bottom 20% with the lowest roll-returns, maintaining these positions for a month. Positions within each quintile are allocated equally to ensure balanced exposure. The approach encompasses the entire spectrum of commodity futures contracts as its investment universe, aiming to capitalize on discrepancies in roll-returns among different commodities.

Economic rationale

Keynes (1930) and Cootner (1960) suggest commodity futures prices are influenced by hedgers' net positions, with risk transferred from producers/consumers to speculators seeking profit from price changes. When short hedgers outweigh long hedgers, futures prices today are likely biased lower than at maturity. Practically, term-structure strategies offer appealing features like lower drawdowns, higher run-ups, and better rolling returns compared to benchmarks, with rewarding risk-adjusted returns. These strategies' returns mirror S&P GSCI fluctuations but are independent of the S&P 500, enhancing equity portfolio diversification. Erb and Harvey note that while individual commodity futures typically yield zero excess return and exhibit low correlation, a diversified, rebalanced futures portfolio could achieve equity-like returns, with term structure and strategy selection driving above-average outcomes. Durr and Voegeli's analysis emphasizes the term structure's structural properties, highlighting the consistent explanatory power of principal components, particularly the level factor, suggesting investment opportunities through term structure insights.

Entry & exit

Entry

On each month, make_on_day sets target weights for GLD, SLV, DBC, GSG, USO, UNG, DBA. Read engine.set_target_weights in the lab code for the exact signal.

Exit

A name is exited when its target weight is set to 0 (or the whole dict is empty = cash). Fills use 5 bps commission and 2 bps slippage.

Market data required

Needs at least 60 adjusted daily closes on GLD, SLV, DBC, GSG, USO, UNG (+1 more) before the first signal is ready. ETF columns print on exchange sessions only. The lab loads Yahoo Finance via backtest.data.load_daily_prices.

Symbols

GLD, SLV, DBC, GSG, USO, UNG, DBA

Frequency

Monthly · Daily adjusted close; signals rebalance on the month change (last available session)

History needed

≥ 60 trading days per symbol (about 3 months), plus a few extra bars so the first signal can fire.

Fields

Adjusted close (Yahoo auto_adjust)
Session date index

Credentials

None for paper and the onsite lab
Broker or exchange API keys only for live orders

APIs & providers

Quant Buffet Data API

The lab calls load_daily_prices for the ASSETS panel of adjusted closes, then caches CSV so backtests replay the same series.

Provider: backtest.data.load_daily_prices
Auth: None for paper / sandbox backtests
Endpoints: load_daily_prices(ASSETS, start="2000-01-01")

API / docs → /en/docs/data-api

Yahoo Finance via yfinance

US equities and ETFs, adjusted OHLCV, free for research (rate limits apply).

Provider: yfinance → Yahoo Finance
Auth: None for public history
Endpoints: Ticker.history / yf.download(auto_adjust=True)

API / docs → github.com/ranaroussi/yfinance

Onsite backtest IDE

Quant Buffet native backtest IDE

Edit and run Quant Buffet Python for Commodity Futures Roll-Return Strategy in the browser. Results update live with equity, drawdown, and metrics charts. Allowed: backtest.data, backtest.engine, backtest.metrics, numpy, pandas. Define ASSETS and make_on_day(prices). Shortcut: Ctrl+Enter. API docs →

IDE · 43 lines

"""
Quant Buffet interactive lab — term-structure-effect-in-commodities
Allowed: backtest.data / backtest.engine / backtest.metrics, numpy, pandas.
Required: a module-level ASSETS list, and def make_on_day(prices) returning (on_day, ready)
"""
from __future__ import annotations

import numpy as np
import pandas as pd

from backtest.data import load_daily_prices
from backtest.engine import EngineConfig, PortfolioEngine
from backtest.metrics import compute_metrics

ASSETS = ['GLD', 'SLV', 'DBC', 'GSG', 'USO', 'UNG', 'DBA']
REBALANCE_ONCE = False

def make_on_day(prices: pd.DataFrame):
    cols = [c for c in ASSETS if c in prices.columns]
    state = {"last": None, "done": False}

    def on_day(engine: PortfolioEngine, dt: pd.Timestamp) -> None:
        available = [s for s in cols if pd.notna(prices.at[dt, s])]
        if not available:
            return
        if REBALANCE_ONCE:
            if state["done"]:
                return
            state["done"] = True
            engine.set_target_weights(dt, {s: 1.0 / len(available) for s in available})
            return
        key = (dt.year, dt.month)
        if state["last"] == key:
            return
        state["last"] = key
        engine.set_target_weights(dt, {s: 1.0 / len(available) for s in available})

    counts = prices[cols].notna().sum(axis=1)
    need = max(1, len(cols) // 2)
    eligible = counts[counts >= need]
    ready = eligible.index.min() if not eligible.empty else None
    return on_day, ready

"""
Quant Buffet interactive lab — term-structure-effect-in-commodities
Allowed: backtest.data / backtest.engine / backtest.metrics, numpy, pandas.
Required: a module-level ASSETS list, and def make_on_day(prices) returning (on_day, ready)
"""
from __future__ import annotations

import numpy as np
import pandas as pd

from backtest.data import load_daily_prices
from backtest.engine import EngineConfig, PortfolioEngine
from backtest.metrics import compute_metrics

ASSETS = ['GLD', 'SLV', 'DBC', 'GSG', 'USO', 'UNG', 'DBA']
REBALANCE_ONCE = False

def make_on_day(prices: pd.DataFrame):
    cols = [c for c in ASSETS if c in prices.columns]
    state = {"last": None, "done": False}

def on_day(engine: PortfolioEngine, dt: pd.Timestamp) -> None:
        available = [s for s in cols if pd.notna(prices.at[dt, s])]
        if not available:
            return
        if REBALANCE_ONCE:
            if state["done"]:
                return
            state["done"] = True
            engine.set_target_weights(dt, {s: 1.0 / len(available) for s in available})
            return
        key = (dt.year, dt.month)
        if state["last"] == key:
            return
        state["last"] = key
        engine.set_target_weights(dt, {s: 1.0 / len(available) for s in available})

counts = prices[cols].notna().sum(axis=1)
    need = max(1, len(cols) // 2)
    eligible = counts[counts >= need]
    ready = eligible.index.min() if not eligible.empty else None
    return on_day, ready

Quant Buffet syntax cheat sheet (copy / insert)

Paste these fragments into the editor. The sandbox rejects QuantConnect, os, and network libraries.

Required imports

Only these libraries are allowed in the sandbox.

from __future__ import annotations

import numpy as np
import pandas as pd

from backtest.data import load_daily_prices
from backtest.engine import EngineConfig, PortfolioEngine
from backtest.metrics import compute_metrics

ASSETS list (whitelisted ETFs)

Module-level list. Tickers must be in the Quant Buffet whitelist.

ASSETS = ["SPY", "QQQ", "TLT", "GLD", "BIL"]

make_on_day contract

Must return (on_day, ready). on_day calls engine.set_target_weights.

def make_on_day(prices: pd.DataFrame):
    cols = [c for c in ASSETS if c in prices.columns]
    sma = prices[cols].rolling(200, min_periods=200).mean()
    state = {"last": None}

    def on_day(engine: PortfolioEngine, dt: pd.Timestamp) -> None:
        if sma.loc[dt].isna().all():
            return
        key = (dt.year, dt.month)
        if state["last"] == key:
            return
        state["last"] = key
        long = [
            s for s in cols
            if pd.notna(prices.at[dt, s]) and pd.notna(sma.at[dt, s])
            and prices.at[dt, s] > sma.at[dt, s]
        ]
        weights = {} if not long else {s: 1.0 / len(long) for s in long}
        engine.set_target_weights(dt, weights)

    ready = sma.dropna(how="all").index.min() if sma.notna().any().any() else None
    return on_day, ready

Set target weights

Weights should sum to about 1.0. Empty dict = 100% cash.

engine.set_target_weights(dt, {"SPY": 0.60, "BIL": 0.40})

Live backtest performance

CAGR

-0.48%

Sharpe

0.07

Max DD

-80.40%

Vol

18.94%

Sortino

0.11

Beta

0.34

Up days

56%

Run the backtest to populate charts.

Order records

Run the backtest to load every order fill alongside performance.

Export to your platform

Transform Quant Buffet lab code (ASSETS + make_on_day / PortfolioEngine) into native classes for a third-party IDE — then copy and paste.

Target platform

Run in: QuantConnect Cloud or LEAN CLI · QCAlgorithm with Equity securities and monthly rebalance.

Detected pattern: Custom / hybridAssets: GLD, SLV, DBC, GSG, USO, UNG, DBA

# Generated from Quant Buffet → QuantConnect LEAN
# Strategy: Commodity Futures Roll-Return Strategy
# Detected pattern: Custom / hybrid
# Source uses Quant Buffet lab APIs (ASSETS + make_on_day / PortfolioEngine).
# Review fees, data, and risk before live trading — educational export only.

from AlgorithmImports import *


class QuantBuffetExport(QCAlgorithm):
    def Initialize(self):
        self.SetStartDate(2010, 1, 1)
        self.SetCash(100000)
        tickers = ["GLD", "SLV", "DBC", "GSG", "USO", "UNG", "DBA"]
        self.symbols = []
        for t in tickers:
            if "-" in t:  # crypto proxy e.g. BTC-USD
                self.symbols.append(self.AddCrypto(t.replace("-USD", ""), Resolution.Daily).Symbol)
            else:
                self.symbols.append(self.AddEquity(t, Resolution.Daily).Symbol)
        self.Schedule.On(
            self.DateRules.MonthStart(self.symbols[0]),
            self.TimeRules.AfterMarketOpen(self.symbols[0], 30),
            self.Rebalance,
        )
        # Logic: Custom Quant Buffet logic — adapt the signal block to match your lab on_day().

    def Rebalance(self):
        # Pattern: custom — Custom Quant Buffet logic — adapt the signal block to match your lab on_day().
        # Default: equal-weight. Port your make_on_day weights here via SetHoldings.
        w = 1.0 / len(self.symbols) if self.symbols else 0.0
        for symbol in self.symbols:
            self.SetHoldings(symbol, w)

Exported code uses the platform’s native classes and libraries. Install dependencies in your third-party IDE, then run. Validate before live trading.