Spec

Frammenti di codice

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

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

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

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "note": "All endpoints take no parameters; they return the current spread/ratio with its components. Crack is USD/barrel, crush USD/bushel. Read fresh per call, nothing cached.",
        "source": "Yahoo Finance futures (CL=F, RB=F, HO=F, NG=F, ZS=F, ZM=F, ZL=F, GC=F, SI=F, HG=F), live",
        "service": "commodityspreads-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/crack": "The 3:2:1 crack spread (refining margin) with components.",
            "GET /v1/crush": "The soybean crush spread (processing margin) with components.",
            "GET /v1/ratios": "Gold/silver, gold/oil, oil/natgas and gold/copper ratios with components."
        },
        "description": "Commodity spreads and ratios — the relationships commodity traders actually position, computed live from the underlying futures (no key, nothing stored). crack returns the 3:2:1 crack spread (refining margin). crush returns the soybean crush spread (processing margin). ratios returns gold/silver, gold/oil, oil/natural-gas and gold/copper. Each comes with the component prices. The commodity-spread / inter-commodity cut — distinct from the single-commodity price feed, the precious-metals spot API and the FX APIs.",
        "upstream_status": "ok",
        "crack_3_2_1_usd_bbl": 44.45
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:29.785Z",
        "request_id": "0b5fede1-3af6-4604-bebe-e50bb2de63f5"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}