Skip to main content
This section is for the LLM-driven trading bots, monitoring agents, and strategy engines that integrate Lumina. If you’re a human trying to buy a policy through a UI, head to lumina-org.com/app instead — these pages assume you’re writing code.

​
Why Lumina is agent-first

Most DeFi insurance protocols were built for humans clicking a UI. Lumina inverts that — every primitive is designed to be hit programmatically by an autonomous process with no human in the loop.
PropertyWhat it means for an agent
Pure HTTP purchase pathOne POST /api/v1/policies call buys cover end-to-end. No transaction signing, no nonce management, no on-chain encoding in the agent.
Relayer-paid gasThe relayer wallet (0x06b1C5117591e2663bD83A66589165505f313c83) submits every transaction. Your wallet needs USDC for the premium and nothing else — no Base mainnet ETH except the one-time onboarding signature.
TypeScript SDK with full types@lumina-org/sdk@^0.6.0 ships first-class types for products, policies, bonds, marketplace listings, webhooks, and the sandbox. Auto-resolves productId hash + per-shield asset from productName.
OpenAPI 3.0.3 specEvery endpoint has a machine-readable schema at /openapi.json. Generate clients in any language; feed it to an LLM for prompt-time tool definitions.
No-wallet sandboxPOST /sandbox/try lets an LLM buy a real Base mainnet policy with zero setup — relayer pays both gas and premium. See Sandbox-first.
Idempotent writesEvery mutating call accepts an Idempotency-Key header. Safe to retry on network blips without double-spending.
Self-service API keysMint a key by signing a message — no human admin in the loop. Up to 3 active keys per wallet.

​
The six things every agent does

NeedEndpoint / SDK
First contact, zero walletlumina.sandbox.try() — see Sandbox-first
Mint an API keylumina.agent.onboard(signer) — see Onboarding
Buy a policylumina.policies.purchase(...) — see First policy
Watch for triggerslumina.webhooks.create(...) — see Webhooks
Read your bond positionslumina.bonds.list() — see Monitor bonds
Trade bondslumina.marketplace.listings(...) — see Strategies

​
Canonical environment

FieldValue
API base URLhttps://lumina-api-production-ac85.up.railway.app
ChainID8453 (Base mainnet)
SDK@lumina-org/sdk@^0.6.0
Relayer wallet0x06b1C5117591e2663bD83A66589165505f313c83
Active products6 (3 BTC + 3 ETH, durations 1h / 24h / 48h)
/health is canonical for every contract address. Hit it once on boot, cache for the lifetime of your process — never hardcode addresses in source.