{"schema_version":"grainbud.ai-api.manifest.v1","contract_version":"grainbud.ai-api.contract.v1","generated_at":"2026-06-29T12:49:03.846Z","name":"GrainBud Portfolio Snapshot API","description":"Read-only personal investment portfolio snapshot API for AI analysis. The Web UI is for humans; this API is the stable AI-facing surface.","base_url":"https://grainbud.poorlow.com","authentication":{"required":false,"mode":["open"],"required_scope":"portfolio:snapshot:read","accepted_credentials":[{"type":"bearer","header":"Authorization","format":"Bearer <token>","recommended":true},{"type":"x-api-token","header":"x-api-token","format":"<token>","recommended":false},{"type":"query","parameter":"token","format":"?token=<token>","recommended":false,"note":"Only use when the AI tool cannot send HTTP headers."}]},"endpoints":[{"id":"portfolio_snapshot","method":"GET","path":"/api/ai/portfolio/snapshot","url":"https://grainbud.poorlow.com/api/ai/portfolio/snapshot","auth_required":false,"description":"Fetch the current confirmed portfolio snapshot, reference quotes, FX estimates, data freshness, source lineage, and risk flags."},{"id":"manifest","method":"GET","path":"/api/ai/manifest","url":"https://grainbud.poorlow.com/api/ai/manifest","auth_required":false,"description":"Machine-readable API discovery document."},{"id":"openapi","method":"GET","path":"/api/ai/openapi","url":"https://grainbud.poorlow.com/api/ai/openapi","auth_required":false,"description":"OpenAPI 3.1 contract for tools that can import an API spec."},{"id":"instructions","method":"GET","path":"/api/ai/instructions","url":"https://grainbud.poorlow.com/api/ai/instructions","auth_required":false,"description":"Markdown instructions that can be pasted into an AI skill or custom GPT action description."},{"id":"agent_markdown","method":"GET","path":"/agent.md","url":"https://grainbud.poorlow.com/agent.md","auth_required":false,"description":"Single-link AI-readable portfolio brief with current holdings table, caveats, and endpoint map."},{"id":"llms_txt","method":"GET","path":"/llms.txt","url":"https://grainbud.poorlow.com/llms.txt","auth_required":false,"description":"Concise AI crawler index that points to the canonical agent brief and machine-readable API contracts."}],"ai_usage_policy":["Treat confirmed_snapshot values as authoritative account facts.","Treat external_quote, NAV, delayed quotes, FX conversions, and external_estimates as reference estimates only.","Do not infer trades, cash transfers, or costs that are not present in the snapshot.","Always surface snapshot.risk_flags, data_freshness_summary, pending imports, stale quotes, stale FX rates, and missing quote coverage in analysis.","This API is read-only. It does not support order placement, order cancellation, trade modification, or account credential operations."]}