Skip to main content

Balances API

Production: Ingress base is https://analytics.snek.fun/balances (this path does not include v1). API routes live under /v1/... — full URLs look like https://analytics.snek.fun/balances/v1/pool/holders. Local dev: http://127.0.0.1:7046 (see service http.port in config). The service exposes the same paths under /v1/... on that host — there is no /balances prefix locally (e.g. http://127.0.0.1:7046/v1/pool/holders). This HTTP service exposes read endpoints backed by the balances pipeline: ranked holders, PnL cards, and aggregate balances in ADA for a set of payment key hashes. Auth: All endpoints documented here are public (no API key or cookie). WebSocket: This service does not expose WebSocket endpoints — use HTTP only.

Endpoints

Interactive spec

Swagger UI lists OpenAPI for this service when it is running (typically GET /docs on the same host; production example: https://analytics.snek.fun/balances/docs).

Identifiers

Use the same asset ID and PKH conventions as in API introduction.