Webapp Reactor API Endpoints

Category: webapp (catalog read) Entity: Reactor (structs.reactor) Base URL: ${webappBaseUrl} (default: http://localhost:8080, public guild webapp: http://crew.oh.energy) Last Updated: May 13, 2026

Overview

Reactors are the chain’s energy source — Alpha Matter staked into a validator. Each reactor row carries a validator address, an owning guild, and an owning player. See knowledge/mechanics/power.md and knowledge/economy/energy-market.md.

Webapp vs consensus — no single-reactor GET. The webapp exposes reactors as catalog reads only (/api/reactor/all|validator|guild|owner/.../page/{n}). There is no GET /api/reactor/{id} in Symfony. To fetch one reactor over HTTP, scan/filter the catalog pages client-side (e.g. guild/{guild_id} then match id). The single-entity path GET /structs/reactor/{id} is the consensus (chain REST) API, not the webapp — don’t mix the two base URLs.

Endpoint Summary

Method Path Description Auth Required
GET /api/reactor/all/page/{page} List every reactor Yes
GET /api/reactor/validator/{validator_address}/page/{page} List reactors backed by a validator Yes
GET /api/reactor/guild/{guild_id}/page/{page} List reactors owned by a guild Yes
GET /api/reactor/owner/{owner}/page/{page} List reactors owned by a player Yes

Endpoint Details

GET /api/reactor/all/page/{page}

Name Type Required Format Description
page integer Yes \d+ Page number

GET /api/reactor/validator/{validator_address}/page/{page}

Name Type Required Format Description
validator_address string Yes bech32 valoper Validator operator address (e.g. structsvaloper1...)
page integer Yes \d+ Page number

GET /api/reactor/guild/{guild_id}/page/{page}

Name Type Required Format Description
guild_id string Yes guild-id Guild identifier
page integer Yes \d+ Page number

GET /api/reactor/owner/{owner}/page/{page}

Name Type Required Format Description
owner string Yes player-id Owning player identifier
page integer Yes \d+ Page number

Responses use the shared envelope ({ "success": true, "errors": {}, "data": [ ...rows ] }); catalog rows are returned directly in data as a flat array with a fixed page size of 100 — if data.length === 100, request the next page. See protocols/webapp-api-protocol.md.