Live data

LUMINA’s public surfaces show only numbers you can verify on-chain. This page explains what is live, the refresh cadence, and what is intentionally not shown yet.

Live (instant on-chain)

Served by the aggregator GET /api/v1/live-stats (cached ~30s server-side) and rendered with ISR (~60s) on the home Hero.

Stat	Source (verifiable)	Refresh
$LUMINA price	`BondVault.priceOracle().getLuminaPrice()`	~30–60s
Bond reserve	`LUMINA.balanceOf(bondVault)`	~30–60s
Capacity used	`BondVault.totalCommittedUSD` / `availableCapacityUSD()`	~30–60s
Total supply	`LUMINA.totalSupply()` (fixed 100M)	~30–60s
Chain / block	RPC `eth_blockNumber` (`/health`)	~30s
Premiums (per product)	`GET /products/{id}/quote`	ISR 1h
API / sequencer status	`GET /health`	on view

Per-user data (your policies, bonds, marketplace listings) is fetched live client-side in the /app (operate) section.

Historical (not shown until the indexer is live)

Cumulative/aggregate figures require event indexing (the Ponder indexer, currently parked). Until it is revived they are omitted, not faked:

Total $LUMINA burned (cumulative)
Active ClaimBonds count / bonds outstanding
Policy volume (24h)
Burn rate (30d)

The endpoints exist (/api/v1/stats/*) but are disabled until the indexer runs.

Verify it yourself (30 seconds)

# Aggregated live stats (every field names its on-chain source)
curl https://lumina-api-production-ac85.up.railway.app/api/v1/live-stats

# Or read directly from the chain
cast call <bondVault> "priceOracle()(address)" --rpc-url https://mainnet.base.org
cast call <oracle>    "getLuminaPrice()(uint256)" --rpc-url https://mainnet.base.org   # 18-dec USD
cast call <lumina>    "balanceOf(address)(uint256)" <bondVault> --rpc-url https://mainnet.base.org
cast call <lumina>    "totalSupply()(uint256)" --rpc-url https://mainnet.base.org       # 100M * 1e18

Resolve <bondVault>, <lumina> from GET /health (contracts map) so you are never reading a stale address.

Degradation

If the API/RPC is unreachable, the aggregator serves the last good snapshot flagged stale: true, and the Hero shows a grey “LAST KNOWN” indicator instead of the green “LIVE” dot — never a fabricated value.

Getting started

Core concepts

For AI agents

MCP

SDK

Contracts

Reference

Live (instant on-chain)

Historical (not shown until the indexer is live)

Verify it yourself (30 seconds)

Degradation

​Live (instant on-chain)

​Historical (not shown until the indexer is live)

​Verify it yourself (30 seconds)

​Degradation

Live (instant on-chain)

Historical (not shown until the indexer is live)

Verify it yourself (30 seconds)

Degradation