{"contract_version":"2026-07-22","contract":{"version":"2026-07-22","source":"cloudflare-worker","routes":[{"path":"/agent","methods":["GET"],"auth":"none","description":"Canonical Stakao Agent API discovery manifest.","url":"https://api.stakao.com/agent"},{"path":"/agent/openapi.json","methods":["GET"],"auth":"none","description":"OpenAPI contract generated from the Worker agent contract.","url":"https://api.stakao.com/agent/openapi.json"},{"path":"/agent/llms.txt","methods":["GET"],"auth":"none","description":"Machine-readable Agent API instructions.","url":"https://api.stakao.com/agent/llms.txt"},{"path":"/agent/errors.json","methods":["GET"],"auth":"none","description":"Machine-readable error codes and remediation hints.","url":"https://api.stakao.com/agent/errors.json"},{"path":"/agent/allocation-analysis","methods":["GET"],"auth":"none","description":"Allocation Analysis endpoint manifest.","url":"https://api.stakao.com/agent/allocation-analysis"},{"path":"/agent/allocation-analysis/catalog","methods":["GET"],"auth":"none","description":"Public allocation analysis product catalog.","url":"https://api.stakao.com/agent/allocation-analysis/catalog"},{"path":"/agent/allocation-analysis/reference-status","methods":["GET"],"auth":"none","description":"Four-hour reference allocation freshness status.","url":"https://api.stakao.com/agent/allocation-analysis/reference-status"},{"path":"/agent/allocation-analysis/allocation/preflight","methods":["POST"],"auth":"none","description":"Free validation and quote before x402 payment.","url":"https://api.stakao.com/agent/allocation-analysis/allocation/preflight"},{"path":"/agent/allocation-analysis/model-portfolio","methods":["GET"],"auth":"x402","payment_required":true,"price":"3 USDC","description":"Direct paid model portfolio allocation snapshot.","informational_only":true,"url":"https://api.stakao.com/agent/allocation-analysis/model-portfolio"},{"path":"/agent/allocation-analysis/allocation","methods":["POST"],"auth":"x402","payment_required":true,"price":"3 USDC","description":"Paid wallet-specific allocation analysis.","informational_only":true,"url":"https://api.stakao.com/agent/allocation-analysis/allocation"},{"path":"/agent/mcp","methods":["GET","POST"],"auth":"none","description":"Public read-only MCP JSON-RPC transport.","informational_only":true,"url":"https://api.stakao.com/agent/mcp"},{"path":"/agent/search","methods":["GET","POST"],"auth":"none","description":"Public Cloudflare AI Search transport.","url":"https://api.stakao.com/agent/search"},{"path":"/agent/account/me","methods":["GET"],"auth":"oauth2","required_scopes":["openid"],"description":"Authenticated account profile and Stakao consent context.","url":"https://api.stakao.com/agent/account/me"},{"path":"/agent/account/wallets","methods":["GET"],"auth":"oauth2","required_scopes":["openid","profile"],"description":"Wallets owned by the authenticated user.","url":"https://api.stakao.com/agent/account/wallets"},{"path":"/agent/account/strategies","methods":["GET"],"auth":"oauth2","required_scopes":["openid","profile"],"description":"Strategies belonging to the authenticated user.","url":"https://api.stakao.com/agent/account/strategies"},{"path":"/agent/account/activation-requests","methods":["POST"],"auth":"oauth2","required_scopes":["openid","profile","email"],"description":"Creates a human-reviewed PENDING activation request only.","url":"https://api.stakao.com/agent/account/activation-requests"},{"path":"/agent/mcp/account","methods":["GET","POST"],"auth":"oauth2","required_scopes":["openid","profile"],"description":"OAuth-protected account MCP card and JSON-RPC transport.","url":"https://api.stakao.com/agent/mcp/account"}],"capabilities":{"transports":["rest","mcp","x402","oauth2"],"public":["discovery","catalog","reference_status","preflight","public_search","public_mcp"],"paid":["model_portfolio_snapshot","wallet_allocation_analysis"],"account":["profile_read","wallet_read","strategy_read","human_reviewed_pending_activation_request"],"creates_agent_decisions_status":"ANALYZED","informational_only":true,"can_activate_strategy":false,"can_execute_on_chain":false,"can_create_delegate_transactions":false},"authentication":{"public":{"type":"none"},"paid":{"type":"x402","protocol_version":2,"rail":"USDC","network":"base","price":"3 USDC"},"account":{"type":"oauth2","bearer":"Authorization: Bearer <token>","scopes":{"profile":["openid"],"wallets":["openid","profile"],"strategies":["openid","profile"],"activation_requests":["openid","profile","email"],"account_mcp":["openid","profile"]}}},"safety":{"creates_agent_decisions_status":"ANALYZED","informational_only":true,"can_activate_strategy":false,"can_execute_on_chain":false,"can_create_delegate_transactions":false}},"name":"Stakao Agent Allocation Analysis","description":"Machine-readable entrypoint for agents paying for informational Stakao Bittensor allocation analysis with x402.","canonical_url":"https://api.stakao.com/agent","allocation_analysis_url":"https://api.stakao.com/agent/allocation-analysis","llms_txt_url":"https://api.stakao.com/agent/llms.txt","errors_url":"https://api.stakao.com/agent/errors.json","human_url":"https://stakao.com","protocol":{"payment":"x402","x402_version":2,"rail":"USDC","network":"base","x402_network":"eip155:8453","facilitator_url":"https://api.cdp.coinbase.com/platform/v2/x402","price":"3 USDC","pay_to":"0x322a03592CA40ed9faBA2CDF772952bBE9868C45"},"endpoints":{"catalog":{"method":"GET","url":"https://api.stakao.com/agent/allocation-analysis/catalog","payment_required":false,"description":"Public catalog of Stakao products available to autonomous agents."},"reference_status":{"method":"GET","url":"https://api.stakao.com/agent/allocation-analysis/reference-status","payment_required":false,"description":"Freshness status for four-hour model portfolio reference allocations."},"model_portfolio_snapshot":{"method":"GET","url":"https://api.stakao.com/agent/allocation-analysis/model-portfolio","payment_required":true,"direct_x402_payment":true,"payment_status_without_signature":402,"query_schema":{"catalog_item_id":"Optional catalog item id from the public catalog. Defaults to quant_strat."},"description":"Paid direct x402 model portfolio analysis snapshot. Does not require a wallet or preflight. Creates an agent_decisions.status=ANALYZED record and never executes on-chain staking."},"openapi":{"method":"GET","url":"https://api.stakao.com/agent/openapi.json","payment_required":false,"description":"OpenAPI description for the agent allocation analysis API."},"errors":{"method":"GET","url":"https://api.stakao.com/agent/errors.json","payment_required":false,"description":"Machine-readable agent error codes and remediation hints."},"mcp":{"methods":["GET","POST"],"url":"https://api.stakao.com/agent/mcp","payment_required":false,"description":"Public read-only MCP JSON-RPC endpoint for catalog, manifest, pricing, and safety tools. It requires no OAuth and exposes no account-bound user data."},"account":{"authentication":"oauth2","endpoints":{"profile":"https://api.stakao.com/agent/account/me","wallets":"https://api.stakao.com/agent/account/wallets","strategies":"https://api.stakao.com/agent/account/strategies","activation_requests":"https://api.stakao.com/agent/account/activation-requests"},"account_mcp":"https://api.stakao.com/agent/mcp/account","account_mcp_methods":["GET","POST"],"account_mcp_tools":["get_account_profile","list_wallets","list_strategies","request_activation"],"scopes":{"profile":["openid"],"wallets":["openid","profile"],"strategies":["openid","profile"],"activation_requests":["openid","profile","email"],"account_mcp":["openid","profile"]},"activation_execution":"pending_human_review_only"},"search":{"method":"GET or POST","url":"https://api.stakao.com/agent/search","payment_required":false,"description":"Public Cloudflare AI Search over Stakao website content, docs, blog posts, agent discovery files, and safety pages.","request_schema":{"query":"natural-language search query","max_results":"optional integer from 1 to 10"}},"allocation":{"method":"POST","url":"https://api.stakao.com/agent/allocation-analysis/allocation","payment_required":true,"preflight_url":"https://api.stakao.com/agent/allocation-analysis/allocation/preflight","status_without_preflight_request_id":428,"payment_status_without_signature":402,"description":"Paid allocation analysis. Agents must first call the free preflight endpoint. Preflight validates the request and returns a Stakao-generated request id/quote to include in the paid body. Creates an agent_decisions.status=ANALYZED record and never executes on-chain staking.","request_schema":{"wallet_address":"Bittensor SS58 wallet address to allocate","catalog_item_id":"Catalog item id from GET /agent/allocation-analysis/catalog","config":"optional object","client_request_id":"Required Stakao-generated request id returned by POST /agent/allocation-analysis/allocation/preflight."}}},"security":{"creates_agent_decisions_status":"ANALYZED","informational_only":true,"can_activate_strategy":false,"can_execute_on_chain":false,"can_create_delegate_transactions":false,"no_financial_or_investment_advice":true,"executes_on_chain":false,"catalog_public":true,"mcp_auth_required":false,"mcp_exposes_account_bound_data":false,"allocation_requires_x402_payment":true,"model_portfolio_snapshot_requires_x402_payment":true,"backend_accepts_worker_signed_requests_only":true,"account_bound_data_requires_oauth":true}}