Stats & historical data - Lumina Protocol

These endpoints are backed by the Ponder indexer, which reconstructs protocol state from on-chain events into Postgres. They return in milliseconds and scale to many concurrent readers — unlike the live eth_getLogs reads behind the /api/v1/public/* endpoints.

On Base mainnet, production volumes are near zero — these endpoints report the real indexed values (often 0), never placeholder numbers.

Base URL

https://lumina-api-production-ac85.up.railway.app

All endpoints below are public (no API key) and IP-rate-limited.

Aggregate stats

`GET /api/v1/stats/burns`

Burn dashboard: total LUMINA burned, premium USDC volume, last-30-day burn, count, and a per-day series.

{
  "total_lumina_burned": "0",
  "total_usdc_volume": "0",
  "last_30_days_burned": "0",
  "burns_count": 0,
  "by_day": [{ "day": "2026-05-26", "lumina_burned": "0", "usdc_spent": "0" }]
}

`GET /api/v1/stats/protocol`

Protocol-wide snapshot.

{
  "active_policies": 0,
  "bonds_outstanding_usd": "0",
  "total_premium_collected": "0",
  "marketplace_volume_total": "0",
  "lumina_total_burned": "0",
  "lumina_circulating": "100000000000000000000000000"
}

lumina_circulating is derived as total supply (100M) − total burned.

`GET /api/v1/stats/activity`

Unified reverse-chronological feed (max 100) across policy purchases, bond mints/redemptions, marketplace buys, and burns.

{ "events": [
  { "type": "policy_purchased", "actor": "0x…", "amount": "100000000", "ref": "12", "tx_hash": "0x…", "block_number": "42037031", "block_timestamp": "1779…" }
], "count": 1 }

type ∈ policy_purchased | bond_minted | bond_redeemed | marketplace_buy | lumina_burned.

`GET /api/v1/stats/lumina-price-history?range=24h`

Effective LUMINA/USDC price points from each BurnExecuted. range ∈ 24h | 7d | 30d | all.

Per-wallet (indexed)

Endpoint	Returns
`GET /api/v1/policies/by-buyer/:address`	Policies for a buyer (paginated `limit`/`offset`).
`GET /api/v1/bonds/by-owner/:address`	Net bond holdings per epoch (issued − redeemed > 0).
`GET /api/v1/triggers/recent?limit=50`	Recent trigger submissions.
`GET /api/v1/marketplace/active-listings`	Active marketplace listings.
`GET /api/v1/marketplace/recent-sales`	Filled listings.
`GET /api/v1/burns/recent?source=TWAPBurner`	Recent burn events.

The legacy on-chain /api/v1/public/policies/:wallet and /api/v1/public/bonds/:wallet endpoints remain available and return the same data via a live on-chain scan — use them as a fallback if /indexer/health reports the indexer is syncing or lagging.

Indexer health

`GET /api/v1/indexer/health`

{ "status": "synced", "lastSyncedBlock": "42037031", "headBlock": "42037050", "lagBlocks": "19" }

status ∈ synced | lagging | syncing. Returns 503 if the indexer/DB is not provisioned.

​Base URL

​Aggregate stats

​GET /api/v1/stats/burns

​GET /api/v1/stats/protocol

​GET /api/v1/stats/activity

​GET /api/v1/stats/lumina-price-history?range=24h

​Per-wallet (indexed)

​Indexer health

​GET /api/v1/indexer/health

Base URL

Aggregate stats

`GET /api/v1/stats/burns`

`GET /api/v1/stats/protocol`

`GET /api/v1/stats/activity`

`GET /api/v1/stats/lumina-price-history?range=24h`

Per-wallet (indexed)

Indexer health

`GET /api/v1/indexer/health`