# Compute Finance — Live Oracle

> Live AI compute pricing across all basket models from major providers. Updated hourly. Published on-chain on Base for independent verification.

This is the live oracle for the Compute Price Index (CPI). The Standard Compute Unit (SCU) is a weighted average of the cost to run a fixed reference workload across the full basket. Three tiers: Frontier, Standard, Lightweight. Current weights and reference workload token counts are published via the API (`GET /v1/oracle/tiers` and `GET /v1/oracle/scu`). V1 does not ship a first-party typed SDK — the machine interfaces are the public REST API, the OpenAPI spec at https://api.compute.finance/v1/openapi.yaml, and the official Compute Finance MCP at https://github.com/compute-finance/compute-finance-mcp (also on npm).

## API

The public REST API is the canonical machine interface for the live oracle. No authentication. JSON responses. Stable schemas. Base URL: `https://api.compute.finance`.

- [OpenAPI specification (YAML)](https://api.compute.finance/v1/openapi.yaml): Machine-readable contract. Also served at `/openapi.yaml` for agents probing conventional paths.
- [OpenAPI specification (JSON)](https://api.compute.finance/v1/openapi.json): Same spec in JSON. Also at `/openapi.json`.
- [Interactive API explorer](https://api.compute.finance/v1/docs): Swagger UI for trying endpoints in the browser.

## Live data

- [Current SCU](https://api.compute.finance/v1/oracle/scu): Returns the current Standard Compute Unit value, basket version, and update timestamp.
- [Full basket](https://api.compute.finance/v1/oracle/models): Returns all basket models with current input/output prices, tier classification, and provider.
- [Tier configuration](https://api.compute.finance/v1/oracle/tiers): Returns tier weights and model groupings.
- [Hourly SCU history](https://api.compute.finance/v1/oracle/history): Returns SCU values over a time range (30d, 90d, 1y, or all).
- [Basket reconstitutions](https://api.compute.finance/v1/oracle/reconstitutions): Returns the log of every basket change since inception.

## Methodology

- [How the SCU is calculated](https://docs.compute.finance#scu-formula): The formula, the workload definition, and worked examples.
- [Basket composition rules](https://docs.compute.finance#basket-rules): Which models qualify, how reconstitution works, what triggers a basket change.
- [On-chain verification](https://docs.compute.finance#on-chain): How to read the SCU directly from the OracleRegistry contract on Base.

## Full content (markdown)

- [Oracle methodology and formulas](https://oracle.compute.finance/index.html.md): Complete static markdown covering the CPI, SCU formula, basket composition, basket rules, on-chain verification, and API endpoint reference.

## Optional

- [Landing page](https://compute.finance/): Brand-level overview of why a public reference price for AI compute matters.
- [Disclaimer](https://compute.finance/disclaimer): Canonical V1 scope statement. Confirms what the CPI is and is not.

## Extended reference

- [Full oracle reference for LLM retrieval](https://oracle.compute.finance/llms-full.txt): Complete SCU formula, basket composition, response shapes, on-chain verification, and citation guidance.