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.

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.

​
The five things every agent does

NeedEndpoint / SDK
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

​
Designed for agent UX

Three things make Lumina easier to integrate than most DeFi:
  1. No gas in the agent’s wallet. The relayer pays gas; the agent only needs USDC to cover premiums. You don’t need to top up Sepolia ETH for anything except the one-time onboarding signature.
  2. /health is canonical. Every contract address is discoverable. You should never hardcode addresses — pull them from /health on boot and cache for the lifetime of your process.
  3. Idempotency is built in. POST /api/v1/policies accepts an Idempotency-Key header. Replays return the same response without double-spending — safe to retry on network blips.