Agent-Native Staking APIs: How AI Agents Buy TAO Allocation Recommendations
How autonomous agents discover Stakao, read the strategy catalog, pay with x402 USDC, and receive recommendation-only Bittensor allocation outputs.
Published Jul 6, 2026 . Stakao . 8 min read
Direct answer
An agent-native staking API is an HTTP interface designed for autonomous software agents rather than only human dashboards. It exposes machine-readable discovery, product catalogs, payment requirements, request schemas, and structured allocation outputs that an agent can evaluate and call safely.
What an AI agent needs before it can buy a staking recommendation
A useful agent needs more than a landing page. It needs a public catalog, a clear request contract, a payment rail, and a safety boundary it can explain back to the user.
- Discovery: llms.txt, api-catalog, OpenAPI, MCP, Link headers, and readable product pages.
- Pricing: a public price, token rail, network, facilitator URL, and merchant wallet.
- Input contract: wallet_address, catalog_item_id, optional config, and client_request_id for idempotence.
- Output contract: a stored agent_decisions record, target allocation, dry-run plan, product metadata, and payment metadata.
- Safety: recommendation_only status, no strategy activation, no delegate transaction, and no on-chain execution.
Stakao exposes a narrow agent surface instead of the whole backend
The public agent surface lives at https://api.stakao.com/agent. It is intentionally small, because agents should only see the product interface they need.
| Endpoint | Payment | Purpose |
|---|---|---|
| GET /agent | No | Top-level manifest for agent discovery, payment metadata, and safety boundaries. |
| GET /agent/recommendations/catalog | No | Public catalog of Stakao products agents can request recommendations for. |
| GET /agent/openapi.json | No | OpenAPI contract for REST-capable agents and tool builders. |
| POST /agent/recommendations/allocation | Yes, x402 USDC | Paid recommendation-only allocation response stored as agent_decisions.status = RECOMMENDED. |
| POST /agent/mcp | No | Read-only MCP tools for catalog, pricing, manifest, safety, and public content search. |
| GET or POST /agent/search | No | Cloudflare AI Search over public Stakao website content and agent documentation. |
Recommendation-only is the right V1 safety model
A paid agent call should not silently become asset management. In Stakao V1, the agent receives an allocation recommendation, not a delegated trading or staking permission.
The response can be useful immediately because it returns a deterministic target allocation for the wallet and selected product. The user or downstream system can inspect the allocation, compare it to the current wallet, and decide whether to act through existing human flows.
This model keeps custody, consent, and execution separate. Humans still activate strategies through the existing Stakao app. Agents can buy research and recommendation outputs without being able to mutate user_strategies or create delegate_transactions.
Implementation checklist for an agent-native staking endpoint
The durable pattern is simple: make discovery public, make expensive computation paid, make execution explicit, and make every paid result auditable.
- Keep catalog and documentation public so agents can evaluate the service before payment.
- Return HTTP 402 with x402 payment requirements before expensive work starts.
- Require a signed internal Worker header at the origin backend.
- Store request hash, wallet, catalog item, payment rail, status, and agent_decision_id.
- Return the same decision on identical retries and return 409 on conflicting retries.
- Use stale-reference checks so fast outputs are also fresh enough to trust.
FAQ
Can an agent activate a Stakao strategy through this API?
No. The V1 agent API is recommendation-only. It can create a paid allocation recommendation with status RECOMMENDED, but it cannot activate a strategy, create delegate transactions, or execute staking.
Does the agent API require a Stakao account?
No. Public discovery, catalog, search, and paid recommendation calls do not require OAuth because they do not access account-bound user data.
What should an agent call first?
Start with https://api.stakao.com/agent, then read the catalog at /agent/recommendations/catalog and the OpenAPI file at /agent/openapi.json.
Related pages
Agent entrypoints
These endpoints are public discovery surfaces. Paid allocation creation remains gated by x402 USDC and returns recommendation-only output.