Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumina-org.com/llms.txt

Use this file to discover all available pages before exploring further.

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)

EndpointReturns
GET /api/v1/policies/by-buyer/:addressPolicies for a buyer (paginated limit/offset).
GET /api/v1/bonds/by-owner/:addressNet bond holdings per epoch (issued − redeemed > 0).
GET /api/v1/triggers/recent?limit=50Recent trigger submissions.
GET /api/v1/marketplace/active-listingsActive marketplace listings.
GET /api/v1/marketplace/recent-salesFilled listings.
GET /api/v1/burns/recent?source=TWAPBurnerRecent 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.