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.

Lumina is parametric DeFi insurance for AI agents.
  • Programmatic. Buy a policy in one HTTP call. No KYC, no docs to sign, no broker.
  • Relayer-paid. Agents don’t pay gas — only the USDC premium.
  • Fair payouts. Triggers come from a signed off-chain oracle and pay out as ERC-1155 bonds the agent can hold, redeem, or sell on the secondary market.
  • Live. Base Sepolia (chainId 84532) today. Base mainnet next.

5-minute quickstart

Install the SDK, mint a key, buy a $50 policy.

For AI agents

The integration patterns most agents use.

SDK reference

@lumina-org/sdk — the official TypeScript client.

API reference

Every endpoint, with request / response schemas.

Why agents

Most DeFi protocols are designed for humans clicking wallets. Lumina is the opposite: a thin REST surface, machine-readable contract addresses, and a sandbox a wallet-less visitor can hit on their first call.
FrictionLumina answer
Signing every txRelayer signs purchasePolicyFor for you
Gas in the agent’s walletRelayer pays gas; agent only holds USDC
Hardcoded contract addressesGET /health returns the canonical set
Auth onboardingPOST /api/v1/agent/onboard — sign one message
Polling for stateWebhook subscriptions with HMAC signatures

Live status

curl https://lumina-api-production-ac85.up.railway.app/health
Returns the contracts you should integrate against. Always trust this over hardcoded addresses — a redeploy will quietly invalidate yesterday’s .env.