Skip to content
GET /v1/meta

Service metadata

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

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

Get an API key

Code snippets

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

Example response

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

{
    "data": {
        "note": "window is 7-365 days (default 90, the classic horizon). The index is the percent of the alt universe that outperformed BTC. Read fresh per call, nothing cached.",
        "source": "Binance daily klines (BTC + top altcoins), live",
        "service": "altseason-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/coins": "The altcoin universe measured against Bitcoin.",
            "GET /v1/index": "The altcoin season index (0-100) with season label and out/under-performer counts (window=90).",
            "GET /v1/leaderboard": "Alts ranked by excess return versus Bitcoin, with leaders and laggards (window=90)."
        },
        "description": "Altcoin Season Index — whether capital is rotating into altcoins or huddling in Bitcoin, live from Binance (no key, nothing stored). index returns the 0-100 altcoin-season index (share of top alts beating BTC over the window), the season label, BTC's return and the out/under-performer counts. leaderboard ranks the alts by excess return versus Bitcoin. coins lists the universe. The altcoin-season / alt-vs-BTC rotation cut — distinct from the market-cap-dominance and global-market APIs (BTC's share of cap, not relative performance), single-coin momentum and price APIs. It answers whether it is altseason.",
        "universe_size": 50,
        "upstream_status": "ok",
        "altcoin_season_index": 28
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:23.453Z",
        "request_id": "85c9a10b-4db7-4bde-b1f6-23204ba98d1f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}