Skip to content
GET /v1/month

Every commodity ranked by historical average return in a calendar month

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/commodityseasonality-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/commodityseasonality-api/v1/month" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/commodityseasonality-api/v1/month", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/commodityseasonality-api/v1/month");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/commodityseasonality-api/v1/month",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Every commodity ranked by its historical average return in December over ~10 years, most seasonally bullish first. Use bullish/bearish for the headline seasonal trades this month.",
        "month": "December",
        "source": "Yahoo Finance",
        "bearish": [
            {
                "name": "Natural Gas",
                "win_rate_pct": 13,
                "avg_return_pct": -17.48
            },
            {
                "name": "Sugar",
                "win_rate_pct": 50,
                "avg_return_pct": -2.26
            },
            {
                "name": "Soybean Oil",
                "win_rate_pct": 25,
                "avg_return_pct": -1.14
            },
            {
                "name": "Coffee",
                "win_rate_pct": 13,
                "avg_return_pct": -1
            },
            {
                "name": "Cotton",
                "win_rate_pct": 60,
                "avg_return_pct": 0.89
            }
        ],
        "bullish": [
            {
                "name": "Lean Hogs",
                "win_rate_pct": 88,
                "avg_return_pct": 9.39
            },
            {
                "name": "Platinum",
                "win_rate_pct": 63,
                "avg_return_pct": 7.48
            },
            {
                "name": "Silver",
                "win_rate_pct": 75,
                "avg_return_pct": 6.75
            },
            {
                "name": "Brent Crude Oil",
                "win_rate_pct": 63,
                "avg_return_pct": 5.75
            },
            {
                "name": "WTI Crude Oil",
                "win_rate_pct": 50,
                "avg_return_pct": 5.54
            }
        ],
        "scanned": 20,
        "month_num": 12,
        "commodities": [
            {
                "name": "Lean Hogs",
                "group": "livestock",
                "years": 8,
                "commodity": "lean_hogs",
                "win_rate_pct": 88,
                "avg_return_pct": 9.39
            },
            {
                "name": "Platinum",
                "group": "metals",
                "years": 8,
                "commodity": "platinum",
                "win_rate_pct": 63,
                "avg_return_pct": 7.48
            },
            {
                "name": "Silver",
                "group": "metals",
                "years": 8,
                "commodity": "silver",
                "win_rate_pct": 75,
                "avg_return_pct": 6.75
            },
            {
                "name": "Brent Crude Oil",
                "group": "energy",
                "years": 8,
                "commodity": "brent",
                "win_rate_pct": 63,
                "avg_return_pct": 5.75
            },
            {
                "name": "WTI Crude Oil",
                "group": "energy",
                "years": 8,
                "commodity": "crude_oil",
                "win_rate_pct": 5
…