Spec

Code snippets

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

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

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

Example response

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

{
    "data": {
        "notes": "Mass in kg or 'solar_masses', distance in m. Non-rotating (Schwarzschild) black hole. The horizon is at r_s; time dilation diverges there.",
        "service": "schwarzschild-api",
        "formulae": {
            "hawking": "T = ħc³/(8πGMk_B)",
            "schwarzschild": "r_s = 2GM/c²",
            "time_dilation": "√(1 − r_s/r)"
        },
        "constants": {
            "G": 6.6743e-11,
            "c": 299792458,
            "k_B": 1.380649e-23,
            "hbar": 1.054571817e-34,
            "solar_mass_kg": 1.98892e+30
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/radius": "Schwarzschild radius, photon sphere and ISCO from a mass.",
            "GET /v1/hawking": "Hawking temperature and evaporation time of a black hole.",
            "GET /v1/time-dilation": "Gravitational time-dilation factor at a distance from a mass."
        },
        "description": "Black-hole general-relativity calculator: Schwarzschild radius and orbits, gravitational time dilation, and Hawking temperature and evaporation time."
    },
    "meta": {
        "timestamp": "2026-06-05T19:50:33.852Z",
        "request_id": "eb15aa82-147a-448d-83b1-bc54e6a35035"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}