API Reference
The implemented read-only data bridge and authenticated administration.
Code exists; Stayers production behavior is not yet verified.
The website exposes indexed read data through a same-origin GET bridge. The N95 API itself is restricted by Cloudflare Access and a private service token; it is not an unauthenticated public database endpoint.
Website data resources
Use GET /api/indexed with a resource query parameter.
| Resource | Parameters | Data |
|---|---|---|
| status | None | Database/indexer readiness and explicit configuration state |
| tokens | Optional limit, 1–100 | Indexed Stayers token identities |
| token | mint | A verified indexed token |
| trades | mint | Finalized executed trade records |
| candles | mint; interval; optional from/to Unix seconds | OHLCV history in SOL quote units |
| graduation | mint | Curve completion and verified migration information |
| survival | mint | Score, stage, coverage, reasons and accounting/position summaries |
| survival/events | mint | Historical stage and discovery events |
| requirements | None | Recorded versioned experimental policy |
| second-wind | None | Active eligible discovery events |
Supported candle intervals are 60, 300, 900, 3600 and 86400 seconds. The endpoint bounds the requested time range and response size; it does not invent gap-filling candles.
Example read
curl "https://YOUR_STAYERS_ORIGIN/api/indexed?resource=requirements"The hostname is a placeholder for the actual deployment, not an additional service to trust.
Responses use an envelope with data, state, reasons and observation information. States include CURRENT, STALE, UNAVAILABLE and NOT_CONFIGURED. A successful HTTP response does not necessarily mean current indexed data exists.
Administrative access
The implemented /api/admin bridge allows declared ledger/health reads and documented evaluation, failed-review and reserve-reclassification actions. Each request needs a one-time authorized wallet message in addition to private server authentication.
There is no completed public fee-claim, automatic distribution or liquidity-execution endpoint to advertise. Wallet transaction APIs used by the website are internal application contracts, not a stable permissionless trading API.
Example unavailable state
{
"state": "NOT_CONFIGURED",
"data": null,
"reasons": ["The Stayers indexing service is not configured."]
}Always inspect state and coverage. Keep backend service tokens, Cloudflare credentials and RPC secrets on the server; never place them in browser requests or example code.
stayers.fun