Catalog and reference
Start with https://api.stakao.com/agent/allocation-analysis/catalog and https://api.stakao.com/agent/allocation-analysis/reference-status.
Catalog links are absolute HTTPS URLs, so an agent can follow product, activation, and CTA links without guessing the human origin. Reference status reports the freshness of the latest reference analysis, so an agent can tell whether a payable snapshot is current before it asks to pay.
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 AI Agent strategy share analysis context but not permissions.
The AI Agent strategy is activated by a person in the Stakao app and runs through a staking-only permission, with a rules-based risk engine making every trade decision. Agent API allocation analysis is anonymous/x402 or account-read OAuth, informational only, and cannot activate or execute staking.