Service metadata

Extraits de code

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

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

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

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "note": "commodity is a key/name/alias (natural_gas, gasoline, GC=F; see /v1/commodities). month is 1-12 or a name (default current month). Averages use ~10 years of monthly returns grouped by calendar month. Read fresh per call, nothing cached.",
        "groups": [
            "energy",
            "metals",
            "grains",
            "softs",
            "livestock"
        ],
        "source": "Yahoo Finance monthly commodity futures, ~10y range, live",
        "service": "commodityseasonality-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/month": "Every commodity ranked by historical average return in a calendar month (month=December).",
            "GET /v1/commodities": "The supported commodities and groups.",
            "GET /v1/seasonality": "One commodity's 12-month seasonal profile with best/worst month and current-month bias (commodity=natural_gas)."
        },
        "description": "Commodity seasonality — the calendar patterns commodity traders position around, from ~10 years of Yahoo Finance monthly futures data (no key, nothing stored). seasonality returns one commodity's 12-month seasonal profile (average return and win rate per calendar month, best/worst month, current-month bias). month ranks every commodity by its historical average return in a given calendar month. commodities lists what is covered. The commodity-seasonality / calendar-pattern cut — distinct from the FX-seasonality API, the commodity-price feed, the commodity-spreads and commodity-momentum APIs.",
        "upstream_status": "ok",
        "commodities_covered": 20,
        "natural_gas_best_month": "October"
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:19.588Z",
        "request_id": "08cb75c3-9052-4bc2-bf36-c0235b5f443d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}