Skip to main content
Lumera Protocol gives you two complementary REST API surfaces. The Lumera LCD endpoint speaks directly to the chain. Use it to query state and broadcast transactions with no middleware in the way. LumeScope sits in front of the network as a neutral, read-only aggregator. It decodes Action metadata for Cascade and Sense, tracks SuperNode hardware metrics, and assembles network-wide statistics. Your application does not have to reconstruct that data from raw chain state. Both surfaces return JSON and require no authentication for read operations.

​
API surfaces

Lumera LCD (native chain API) is the standard Cosmos SDK REST interface served by any lumerad node. Use it when you need to submit transactions, query on-chain parameters, or access data that LumeScope does not index. LumeScope API is a purpose-built aggregator that decodes, stores, and serves Lumera-specific data in developer-friendly shapes. It is the recommended starting point for application developers who want paginated Action lists, decoded metadata, and SuperNode health without writing their own chain-indexing logic.

​
Base URLs

All examples in this documentation target mainnet. Replace the base URL with the testnet equivalent when developing against lumera-testnet-2.

​
Authentication

All LumeScope endpoints are public. No API key or bearer token is required. You can call any endpoint directly from a browser, curl, or your application’s HTTP client.

​
Response format

Every LumeScope response is JSON. Successful responses use HTTP 200 status codes. Error responses include a machine-readable error field and an appropriate 4xx or 5xx status code.

​
OpenAPI specification and interactive docs

LumeScope embeds a full OpenAPI 3.0 specification and an interactive Swagger UI. Use them to explore and test every endpoint. For example, on mainnet browse to https://api.lumera.io/docs to open the interactive documentation.

​
Explore the API

Actions API

Query Cascade and Sense actions with decoded metadata, transaction lifecycle tracking, and aggregated statistics.

SuperNodes API

Fetch SuperNode hardware metrics, payment statistics, version compatibility matrix, and availability status.

​
Self-hosting LumeScope

You can run LumeScope yourself with a single Docker command. A private deployment gives you custom sync intervals, data sovereignty, and your own analytics pipeline. See the LumeScope deployment guide for instructions.