# Compute Finance — Documentation

> Methodology and public REST API reference for the Compute Price Index (CPI). How the Standard Compute Unit is calculated, how the basket is composed, how to verify the on-chain publication, and how to query the free public API.

The CPI is built on a deterministic methodology. Anyone can reconstitute the SCU from the published basket and current provider pricing. The API is free, public, and unauthenticated. V1 does not ship a first-party typed SDK — the machine interfaces are the OpenAPI specification and the official Compute Finance MCP at https://github.com/compute-finance/compute-finance-mcp (also on npm).

## Methodology

- [SCU formula](https://docs.compute.finance#scu-formula): The cost of one Standard Compute Unit, calculated from a reference workload averaged across the basket.
- [Basket composition](https://docs.compute.finance#basket): All basket models in three tiers (Frontier, Standard, Lightweight) across major providers. Current weights: `GET /v1/oracle/tiers`.
- [Basket rules](https://docs.compute.finance#basket-rules): When and how the basket changes. The rules for inclusion, removal, and emergency reconstitution.
- [On-chain verification](https://docs.compute.finance#on-chain): How to read the SCU directly from the OracleRegistry smart contract on Base.

## Public API

- [API overview](https://docs.compute.finance#api-overview): No authentication. JSON responses. Stable schemas. Free for all reasonable use.
- [Endpoints](https://docs.compute.finance#api-endpoints): /v1/oracle/scu, /v1/oracle/models, /v1/oracle/history, /v1/oracle/reconstitutions, /v1/oracle/tiers, /v1/oracle/health.
- [OpenAPI specification (YAML)](https://api.compute.finance/v1/openapi.yaml): Machine-readable contract for the public API. Auto-generated from live NestJS controllers — always in sync with the running server. Use it to generate typed clients in any language (openapi-generator, openapi-typescript, oapi-codegen).
- [OpenAPI specification (JSON)](https://api.compute.finance/v1/openapi.json): Same spec in JSON form.
- [Interactive API explorer](https://api.compute.finance/v1/docs): Swagger UI — try endpoints live in the browser.
- [Code examples](https://docs.compute.finance#api-examples): cURL, Python (urllib), TypeScript (fetch), Go (net/http). No SDK required.
- [Response schemas](https://docs.compute.finance#response-schemas): Field-by-field documentation of what each endpoint returns.

## Identity and engagement

- [Compute Finance ID](https://docs.compute.finance#cf-id): Unified identity across all surfaces. Email or wallet authentication. CF ID format and lifecycle.
- [Points](https://docs.compute.finance#points): Engagement tracking. No monetary value. Tiers: Explorer, Starter, Builder, Architect, Titan.
- [Referral program](https://docs.compute.finance#referrals): Unique link per CF ID, 30-day attribution cookie, 250 points to referrer + 50 points to referred.

## Full content (markdown)

- [Complete documentation](https://docs.compute.finance/index.html.md): Full static markdown covering methodology, API reference with code examples, response schemas, CF ID, points, and referral program.

## Optional

- [Live oracle](https://oracle.compute.finance/): Current SCU value and basket. Open this if you want to see the data behind the methodology.
- [Landing page](https://compute.finance/): Brand-level overview.
- [Disclaimer](https://compute.finance/disclaimer): Canonical V1 scope statement.

## Extended reference

- [Full documentation reference for LLM retrieval](https://docs.compute.finance/llms-full.txt): Complete methodology, API reference, response schemas, and program documentation.