---
title: "Get Supply"
method: GET
path: "/v1/lambda/supply"
tags: ["lambda"]
---

# Get Supply

`GET /v1/lambda/supply`

## Request

- Base URL: `https://alive-api.alphakek.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://alive-api.alphakek.ai/v1/lambda/supply`
- Auth: none declared

Get total λ supply metrics.

Public endpoint — no authentication required.
Math lives in `alive.lp.supply.compute_lambda_supply` so this
endpoint and `/v1/stats` can't drift (see #194).

## Response `200`

Successful Response

- SupplyResponse: Total λ supply metrics.
  - `total_minted` number, required: Total λ ever brought into existence. Derived as circulating + total_burned.
  - `total_burned` number, required: Net λ removed from circulation (burn + fee + query - refund). Not gross burned.
  - `circulating` number, required: Currently circulating λ — sum of accounts.balance across all accounts (trigger-maintained from the v2 ledger).

## Changes

- **2026-10-16** `b6d96e7673dc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alphakek-ai/apis/aikek-api/changes/v1/lambda/supply/get.md)

---

[API](https://skmtc.dev/alphakek-ai/apis/aikek-api.md) - [All operations](https://skmtc.dev/alphakek-ai/apis/aikek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alphakek-ai/apis/aikek-api/revisions/b6d96e7673dc?raw)