API status

The Lumina API exposes a single status endpoint. There’s no separate status page provider — /health is the source of truth, and you can poll it directly:

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

Live response

What the fields mean

Field	Meaning
`status`	`ok` if the service is processing requests; `degraded` otherwise
`chain.chainId`	Always 8453 (Base mainnet) on the current deploy
`chain.block`	The most recent block the API has observed via RPC
`chain.rpcConnected`	`false` indicates the upstream RPC is unreachable — buys/triggers will start failing soon
`relayer.address`	The wallet that signs `purchasePolicyFor`
`relayer.balanceWei`	Refresh budget for gas. Below ~0.005 ETH means re-fund is overdue
`contracts`	Map of canonical contract addresses

Programmatic monitoring

import { LuminaClient } from '@lumina-org/sdk'

const lumina = new LuminaClient({ apiKey: '' })
const h = await lumina.health()

if (!h.chain.rpcConnected) alert('RPC down')
if (BigInt(h.relayer.balanceWei) < 5_000_000_000_000_000n) alert('relayer low gas')

Schema

The full response schema is in the OpenAPI spec at /openapi.json (search components.schemas.Health).

Getting started

Core concepts

For AI agents

MCP

SDK

Contracts

Reference

Live response

What the fields mean

Programmatic monitoring

Schema

​Live response

​What the fields mean

​Programmatic monitoring

​Schema

Live response

What the fields mean

Programmatic monitoring

Schema