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

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

Get an API key

Code snippets

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

Example response

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

{
    "data": {
        "sample": {
            "first_pool": "pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt"
        },
        "source": "public Koios API (api.koios.rest), keyless",
        "service": "cardanopools-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One pool in full: ticker/name plus live stake, saturation, delegators (pool_id; omit for the first).",
            "GET /v1/pools": "The stake-pool registry: margin, fixed cost, pledge (limit, offset).",
            "GET /v1/snapshot": "A pool's Mark/Set/Go stake snapshots per epoch (pool_id; omit for the first)."
        },
        "description": "Read Cardano's stake-pool operators (SPOs) live from the public Koios API: list the pools with margin, fixed cost and pledge, look up one pool in full with its registered identity (ticker, name, homepage) and on-chain economics (live stake, saturation, delegators, blocks), and read a pool's Mark/Set/Go stake snapshots. The operator layer for Cardano wallets, staking dashboards and pool explorers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:22.812Z",
        "request_id": "dded3bb7-4572-4e58-aebd-125b636b827e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}