Skip to main content
The Alterscope Developer API delivers institutional DeFi risk data through one HTTP API: oracle classification and per-block price history, vault liquidity and exit simulation, curator track records, cross-protocol exposure, and a knowledge-graph view of how risk spreads between protocols. Every response also carries a machine-readable freshness and quality signal, so an automated consumer can tell how much to trust a number before acting on it. This section gets you from zero to your first authenticated call. If you’re evaluating the data or methodology rather than integrating, start with Why Alterscope and Trust & Methodology instead.

Get an API key

Free tier in about a minute. No credit card.

Quickstart

Make your first authenticated request in ~5 minutes.

Authentication

API keys, headers, rotation, and revocation.

API reference

Every endpoint, request shape, and response field.

​
Base URL

​
How a response is shaped

Every endpoint returns a JSON envelope with two top-level keys: data (the result) and meta (request metadata). On /v2/* endpoints, meta._agentic carries the freshness and quality signal, and the same information is mirrored in the X-Schema-Version and X-Quality-Gate response headers. 
{
  "data": { "...": "endpoint result" },
  "meta": {
    "request_id": "req_…",
    "_agentic": {
      "freshness": { "status": "fresh" },
      "quality_gate": { "verdict": "pass" }
    }
  }
}
The freshness status and quality gate are first-class fields — your client can branch on them rather than guessing whether a number is current. The full contract, every field, and the exact enum values are documented in Concepts → Response envelope and Freshness & staleness.

​
Authentication at a glance

Requests authenticate with an API key (prefixed sk_live_) passed as a bearer token: See Authentication for key rotation and revocation, and Scopes for what each key can access.

​
Where to go next

  • Quickstart — your first call.
  • Scopes — the permissions a key can hold.
  • Rate limits — per-tier request and quota limits.
  • Errors — the error envelope and how to handle each status.
  • Glossary — definitions for any unfamiliar term used here.