{"contract_version":"2026-07-22","codes":{"invalid_request":{"http_status":400,"retryable":false,"remediation":"Check the request body, query parameters, and OpenAPI schema.","docs_url":"https://stakao.com/docs/errors"},"payment_required":{"http_status":402,"retryable":true,"remediation":"Read the PAYMENT-REQUIRED response, pay the x402 USDC requirement, then retry the exact request.","docs_url":"https://stakao.com/docs/x402"},"auth_required":{"http_status":401,"retryable":false,"remediation":"Provide a valid Supabase OAuth bearer token for the account-bound endpoint.","docs_url":"https://stakao.com/docs/oauth"},"insufficient_scope":{"http_status":403,"retryable":false,"remediation":"Request the required OAuth scope and obtain active Stakao consent for the client.","docs_url":"https://stakao.com/docs/oauth"},"not_found":{"http_status":404,"retryable":false,"remediation":"Check the endpoint URL or referenced resource identifier.","docs_url":"https://stakao.com/docs/errors"},"request_conflict":{"http_status":409,"retryable":false,"remediation":"Reuse the original request body with the same client_request_id or start a fresh preflight.","docs_url":"https://stakao.com/docs/x402"},"preflight_required":{"http_status":428,"retryable":false,"remediation":"Call the free allocation preflight endpoint first and reuse its client_request_id.","docs_url":"https://stakao.com/docs/x402"},"rate_limited":{"http_status":429,"retryable":true,"remediation":"Wait for the retry-after window, then retry the request.","docs_url":"https://stakao.com/docs/errors"},"body_too_large":{"http_status":413,"retryable":false,"remediation":"Reduce the request body to the documented maximum size.","docs_url":"https://stakao.com/docs/errors"},"reference_unavailable":{"http_status":503,"retryable":true,"remediation":"Wait for the next four-hour reference refresh and retry after retry-after.","docs_url":"https://stakao.com/docs/allocation-analysis"},"origin_unavailable":{"http_status":503,"http_statuses":[502,503],"retryable":true,"remediation":"Retry later; no payment or on-chain action was requested.","docs_url":"https://stakao.com/docs/errors"},"unsupported_operation":{"http_status":400,"retryable":false,"remediation":"Use one of the operations listed in the agent contract.","docs_url":"https://stakao.com/docs/mcp"},"unknown":{"http_status":500,"retryable":false,"remediation":"Inspect the request id and contact Stakao if the error persists.","docs_url":"https://stakao.com/docs/errors"}},"errors":[{"code":"invalid_request","http_status":400,"retryable":false,"remediation":"Check the request body, query parameters, and OpenAPI schema.","docs_url":"https://stakao.com/docs/errors"},{"code":"payment_required","http_status":402,"retryable":true,"remediation":"Read the PAYMENT-REQUIRED response, pay the x402 USDC requirement, then retry the exact request.","docs_url":"https://stakao.com/docs/x402"},{"code":"auth_required","http_status":401,"retryable":false,"remediation":"Provide a valid Supabase OAuth bearer token for the account-bound endpoint.","docs_url":"https://stakao.com/docs/oauth"},{"code":"insufficient_scope","http_status":403,"retryable":false,"remediation":"Request the required OAuth scope and obtain active Stakao consent for the client.","docs_url":"https://stakao.com/docs/oauth"},{"code":"not_found","http_status":404,"retryable":false,"remediation":"Check the endpoint URL or referenced resource identifier.","docs_url":"https://stakao.com/docs/errors"},{"code":"request_conflict","http_status":409,"retryable":false,"remediation":"Reuse the original request body with the same client_request_id or start a fresh preflight.","docs_url":"https://stakao.com/docs/x402"},{"code":"preflight_required","http_status":428,"retryable":false,"remediation":"Call the free allocation preflight endpoint first and reuse its client_request_id.","docs_url":"https://stakao.com/docs/x402"},{"code":"rate_limited","http_status":429,"retryable":true,"remediation":"Wait for the retry-after window, then retry the request.","docs_url":"https://stakao.com/docs/errors"},{"code":"body_too_large","http_status":413,"retryable":false,"remediation":"Reduce the request body to the documented maximum size.","docs_url":"https://stakao.com/docs/errors"},{"code":"reference_unavailable","http_status":503,"retryable":true,"remediation":"Wait for the next four-hour reference refresh and retry after retry-after.","docs_url":"https://stakao.com/docs/allocation-analysis"},{"code":"origin_unavailable","http_status":503,"http_statuses":[502,503],"retryable":true,"remediation":"Retry later; no payment or on-chain action was requested.","docs_url":"https://stakao.com/docs/errors"},{"code":"unsupported_operation","http_status":400,"retryable":false,"remediation":"Use one of the operations listed in the agent contract.","docs_url":"https://stakao.com/docs/mcp"},{"code":"unknown","http_status":500,"retryable":false,"remediation":"Inspect the request id and contact Stakao if the error persists.","docs_url":"https://stakao.com/docs/errors"}],"docs_url":"https://stakao.com/docs/errors"}