Query endpoints by entity

Version: 1.0.0
Purpose: Query endpoints split from endpoints.md for context window efficiency

Overview

This directory contains query endpoints organized by entity type. This allows AI agents to load only the endpoints they need, reducing context window usage.

Use Case: Load specific entity query endpoints when working with that entity, instead of loading the entire endpoints.md (1153 lines).

Queries are reads. They do not spend charge the way transactions do, but they still hit the node and they still return string numerics — see integration notes before you parse amounts as JSON numbers. If you need a live, sub-second view of the same entities, that is Guild Stack / PostgreSQL, not these REST routes.

Available Query Files

Core Entity Queries

player.md - Player query endpoints (~50 lines)
planet.md - Planet query endpoints (~60 lines)
struct.md - Struct query endpoints (~40 lines)
fleet.md - Fleet query endpoints (~50 lines)
guild.md - Guild query endpoints (~40 lines)

Resource Entity Queries

reactor.md - Reactor query endpoints (~40 lines)
substation.md - Substation query endpoints (~40 lines)

Economic Entity Queries

provider.md - Provider query endpoints
agreement.md - Agreement query endpoints
allocation.md - Allocation query endpoints
infusion.md - Infusion query endpoints (reactor/generator)

Attributes and grid

grid.md - Grid attribute queries (capacity, load, ore)
struct-type.md - Struct type catalog
struct-attribute.md - Per-struct health/status/ambit
planet-attribute.md - Per-planet clocks, shields, slots
guild-membership-application.md - Invite/request rows

Pagination

Every list endpoint uses Cosmos key pagination: pagination.limit defaults to 100 and is silently clamped to 1000; pagination.count_total is silently forced off (total is always 0); pagination.offset above 1000 is refused (pagination offset exceeds maximum; use pagination key). Walk with next_key. See patterns/pagination.md.

System Queries

system.md - Block height, params, vault address lookup, validate-signature

Other Queries

address.md - Address query endpoints (~50 lines)
permission.md - Permission query endpoints (~70 lines)

Context Window Savings

Before (Loading endpoints.md)

To get Player endpoints:

Load: api/endpoints.md (1153 lines)
Contains: All query, transaction, and webapp endpoints
Waste: ~1100 lines of unused endpoints

After (Loading entity query file)