Docs / Allocation Analysis
Allocation Analysis
Catalog, reference freshness, preflight, payment, and structured response semantics for Stakao allocation analysis.
Updated 2026-07-22
Catalog and reference
Start with https://api.stakao.com/agent/allocation-analysis/catalog and https://api.stakao.com/agent/allocation-analysis/reference-status.
The Worker normalizes catalog links to absolute HTTPS URLs so an agent can follow product, activation, and CTA links without guessing the human origin. Reference status reports whether the four-hour model portfolio snapshot is fresh enough to request payment.
Inspect the free surfaces
bash
curl -sS https://api.stakao.com/agent/allocation-analysis/catalog
curl -sS https://api.stakao.com/agent/allocation-analysis/reference-statusWallet-specific preflight
Preflight validates the request before any payment is requested.
- Validate the Bittensor wallet address and readable balance.
- Resolve the server-owned catalog item and accepted configuration.
- Check reference freshness and analysis availability.
- Return a Stakao-generated quote id for the paid retry.
Structured result
The paid response is intentionally compact and machine-readable.
- decision.status is ANALYZED.
- decision.informational_only is true.
- payment records the x402 rail and completed payment context.
- The result is not investment advice and is not an execution instruction.
Response shape
json
{"decision":{"status":"ANALYZED","informational_only":true},"product":{},"payment":{}}Execution boundary
The Agent API and the human Agent Premium product share analysis context but not permissions.
Agent Premium is enabled by a human and may run a limited staking-only proxy workflow with recurring checks. Agent API allocation analysis is anonymous/x402 or account-read OAuth, informational only, and cannot activate or execute staking.
Agent entrypoints