Skip to content
GET /v1/meta

Service metadata and ratio list

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/marketratios-api

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

Get an API key

Code snippets

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

Example response

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

{
    "data": {
        "ratios": {
            "oil_gas": "Oil / Natural Gas",
            "gold_oil": "Gold / Oil",
            "spx_gold": "S&P 500 / Gold",
            "copper_gold": "Copper / Gold",
            "stocks_bonds": "Stocks / Bonds (SPY/TLT)"
        },
        "source": "Yahoo Finance public chart API (live)",
        "service": "marketratios-api",
        "endpoints": {
            "GET /v1/list": "The whole ratio board in one call.",
            "GET /v1/meta": "This document.",
            "GET /v1/ratio": "One intermarket ratio (ratio=gold_oil|oil_gas|copper_gold|spx_gold|stocks_bonds)."
        },
        "description": "Live intermarket relative-value ratios from Yahoo Finance: Gold/Oil (barrels per ounce), Oil/Gas energy spread, Copper/Gold (growth & rate barometer), S&P 500 priced in gold, and Stocks/Bonds (SPY/TLT risk-on/off). Each with both leg prices, the ratio, day change and a plain-language reading. Get one ratio or the whole board. Live, no key. Distinct from single-asset price APIs and from the precious-metals ratio — this is the cross-asset ratio set.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:06.541Z",
        "request_id": "316ba0d3-d24a-4b65-8633-e2bfbf1a5771"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}