# Alterscope Developer API

> 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 contagion. Every response carries a machine-readable freshness and quality signal (the agentic envelope). Production base URL: https://api.alterscope.org

## Get started

- [Introduction](https://docs.alterscope.org/develop/get-started/introduction): What the API is, who it's for, and the response shape.
- [Quickstart](https://docs.alterscope.org/develop/get-started/quickstart): First authenticated call in about five minutes.
- [Authentication](https://docs.alterscope.org/develop/get-started/authentication): API keys (`sk_live_`), Bearer auth, rotation.
- [Scopes](https://docs.alterscope.org/develop/get-started/scopes): Permission scopes a key can hold.
- [Rate limits](https://docs.alterscope.org/develop/get-started/rate-limits): Per-tier request and quota limits.
- [Errors](https://docs.alterscope.org/develop/get-started/errors): Error envelope, status codes, and retry guidance.

## Concepts

- [Response envelope](https://docs.alterscope.org/develop/concepts/response-envelope): The `{ data, meta }` contract and the `meta._agentic` block.
- [Freshness & staleness](https://docs.alterscope.org/develop/concepts/freshness-and-staleness): The freshness status enum and quality-gate verdict.
- [Agentic envelope](https://docs.alterscope.org/develop/concepts/agentic-envelope): Consuming the freshness/quality signal as an automated agent.
- [Glossary](https://docs.alterscope.org/develop/concepts/glossary): Definitions for the terms used across the docs.

## SDKs

- [SDKs overview](https://docs.alterscope.org/develop/sdks/overview): TypeScript, Python, Go, and raw HTTP.
- [TypeScript](https://docs.alterscope.org/develop/sdks/typescript): `@alterscope/sdk`.
- [Python](https://docs.alterscope.org/develop/sdks/python): `alterscope` (sync + async).
- [curl](https://docs.alterscope.org/develop/sdks/curl): Raw HTTP examples.

## Realtime & AI

- [WebSockets](https://docs.alterscope.org/develop/realtime/websockets): Live data streams.
- [Webhooks](https://docs.alterscope.org/develop/realtime/webhooks): Signed event webhooks and replay.
- [MCP server](https://docs.alterscope.org/develop/ai-and-mcp/mcp-server): Connect an AI agent via the Model Context Protocol.

## API reference

- [API reference](https://docs.alterscope.org/api-reference/overview): Endpoint reference, base URLs, and conventions.
- [Versioning](https://docs.alterscope.org/api-reference/versioning): Breaking-change and deprecation policy.