One commodity 12-month seasonal profile with best/worst month and current bias

Codefragmenten

curl "https://api.oanor.com/commodityseasonality-api/v1/seasonality" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/commodityseasonality-api/v1/seasonality", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/commodityseasonality-api/v1/seasonality");
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/seasonality",
    headers={"x-oanor-key": "oanor_test_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "data": {
        "name": "Natural Gas",
        "note": "Average month-over-month return in each calendar month over ~10 years, with win_rate_pct (share of years that month was positive) and the sample size (years). Seasonal tendencies are statistical, not guarantees. Not financial advice.",
        "group": "energy",
        "months": [
            {
                "month": "January",
                "years": 8,
                "month_num": 1,
                "win_rate_pct": 50,
                "avg_return_pct": 0.21
            },
            {
                "month": "February",
                "years": 9,
                "month_num": 2,
                "win_rate_pct": 22,
                "avg_return_pct": -7.86
            },
            {
                "month": "March",
                "years": 8,
                "month_num": 3,
                "win_rate_pct": 50,
                "avg_return_pct": 2.16
            },
            {
                "month": "April",
                "years": 9,
                "month_num": 4,
                "win_rate_pct": 67,
                "avg_return_pct": 2.44
            },
            {
                "month": "May",
                "years": 9,
                "month_num": 5,
                "win_rate_pct": 56,
                "avg_return_pct": 4.48
            },
            {
                "month": "June",
                "years": 10,
                "month_num": 6,
                "win_rate_pct": 30,
                "avg_return_pct": 0.04
            },
            {
                "month": "July",
                "years": 8,
                "month_num": 7,
                "win_rate_pct": 38,
                "avg_return_pct": 1.63
            },
            {
                "month": "August",
                "years": 9,
                "month_num": 8,
                "win_rate_pct": 78,
                "avg_return_pct": 8.27
            },
            {
                "month": "September",
                "years": 8,
                "month_num": 9,
                "win_rate_pct": 63,
                "avg_return_pct": 4.86
            },
            {
                "month": "October",
                "years": 8,
                "month_num": 10,
                "win_rate_pct": 75,
                "avg_return_pct": 12.38
            },
            {
                "month": "November",
                "years": 9,
                "month_num": 11,
                "win_rate_pct": 67,
                "avg_return_pct": 7.79
            },
            {
                "month": "December",
                "years": 8,
                "month_num": 12,
                "win_rate_pct": 13,
                "avg_return_pct": -17.48
            }
        ],
        "source": "Yahoo Finance",
        "symbol": "NG=F",
        "commodity": "natural_gas",
        "best_month": {
            "month": "October",
            "win_rate_pct": 75,
            "avg_return_pct": 12.38
        },
        "wors
…