{"openapi":"3.1.0","info":{"title":"VaultBags Agent API","version":"1.0.0","description":"Read-only access to the VaultBags autonomous treasury: today's allocation, the daily briefing, the market signals and honest track record behind it, live treasury stats, decision history with on-chain receipts, every integrated project's treasury, and condensed docs. Every endpoint returns public data assembled server-side in fixed schemas. Nothing here moves funds or signs anything. An equivalent Model Context Protocol server is available at /api/mcp."},"servers":[{"url":"https://vaultbags.app"}],"paths":{"/api/agent/todays-allocation":{"get":{"operationId":"get_todays_allocation","summary":"Today's RWA buy proportions, band, rationale and on-chain receipt.","description":"Today's RWA buy proportions, band, rationale and on-chain receipt. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/daily-briefing":{"get":{"operationId":"get_daily_briefing","summary":"Today's public market briefing, weights and on-chain receipt.","description":"Today's public market briefing, weights and on-chain receipt. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/treasury-stats":{"get":{"operationId":"get_treasury_stats","summary":"Live per-asset balances, total value, and totals paid to holders.","description":"Live per-asset balances, total value, and totals paid to holders. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/decision-history":{"get":{"operationId":"get_decision_history","summary":"Recent daily decisions with on-chain receipts, newest first.","description":"Recent daily decisions with on-chain receipts, newest first. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"days","in":"query","required":false,"description":"How many recent days to return (default 14, max 30).","schema":{"type":"integer","minimum":1,"maximum":30}}]}},"/api/agent/market-signals":{"get":{"operationId":"get_market_signals","summary":"The market signals behind today's allocation, each with its per-asset read.","description":"The market signals behind today's allocation, each with its per-asset read. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/brain-vs-flat":{"get":{"operationId":"get_brain_vs_flat","summary":"Honest track record: the daily allocation line versus a fixed even split.","description":"Honest track record: the daily allocation line versus a fixed even split. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/simulate":{"get":{"operationId":"simulate_allocation","summary":"Run the vault's allocation model on your own market inputs.","description":"Run the vault's allocation model on your own market inputs. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"realYield","in":"query","required":false,"description":"10-year real (TIPS) yield, percent (e.g. 2.1).","schema":{"type":"number"}},{"name":"breakevenInfl","in":"query","required":false,"description":"10-year breakeven inflation, percent.","schema":{"type":"number"}},{"name":"dxyChangePct","in":"query","required":false,"description":"Broad US dollar index percent change over ~1 month.","schema":{"type":"number"}},{"name":"goldMomentumPct","in":"query","required":false,"description":"Gold price percent change (recent trend).","schema":{"type":"number"}},{"name":"hyOas","in":"query","required":false,"description":"US High Yield credit spread (OAS), percent.","schema":{"type":"number"}},{"name":"vix","in":"query","required":false,"description":"CBOE volatility index (VIX) level.","schema":{"type":"number"}},{"name":"spx30dPct","in":"query","required":false,"description":"S&P 500 percent change over ~1 month.","schema":{"type":"number"}},{"name":"tenYear","in":"query","required":false,"description":"10-year Treasury nominal yield, percent.","schema":{"type":"number"}},{"name":"curve10y2y","in":"query","required":false,"description":"10-year minus 2-year Treasury spread, percent.","schema":{"type":"number"}},{"name":"fearGreed","in":"query","required":false,"description":"Crypto Fear & Greed index, 0 to 100.","schema":{"type":"number"}}]}},"/api/agent/projects":{"get":{"operationId":"get_projects","summary":"Every treasury currently running on VaultBags (not just $VAULT).","description":"Every treasury currently running on VaultBags (not just $VAULT). Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/project-treasury":{"get":{"operationId":"get_project_treasury","summary":"One integrated project's live treasury (claim/lock pools, value) by mint.","description":"One integrated project's live treasury (claim/lock pools, value) by mint. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"mint","in":"query","required":true,"description":"The project's SPL token mint address (base58).","schema":{"type":"string"}}]}},"/api/agent/vault-docs":{"get":{"operationId":"get_vault_docs","summary":"Condensed protocol documentation and live surface links.","description":"Condensed protocol documentation and live surface links. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/rwas":{"get":{"operationId":"list_rwas","summary":"Curated, on-chain-certified registry of tokenized RWAs on Solana (gold, treasuries, equities).","description":"Curated, on-chain-certified registry of tokenized RWAs on Solana (gold, treasuries, equities). Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"category","in":"query","required":false,"description":"Filter by asset category.","schema":{"type":"string"}},{"name":"issuer","in":"query","required":false,"description":"Filter by issuer id.","schema":{"type":"string"}}]}},"/api/agent/rwa":{"get":{"operationId":"get_rwa","summary":"Resolve one tokenized RWA's certified mint and issuer context by symbol or mint.","description":"Resolve one tokenized RWA's certified mint and issuer context by symbol or mint. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"query","in":"query","required":true,"description":"A token symbol (case-insensitive) or an exact Solana mint address.","schema":{"type":"string"}}]}},"/api/agent/protocol-meter":{"get":{"operationId":"get_protocol_meter","summary":"The Meter: the protocol's live, receipt-backed numbers in one consolidated snapshot.","description":"The Meter: the protocol's live, receipt-backed numbers in one consolidated snapshot. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/autonomy":{"get":{"operationId":"get_autonomy","summary":"The vault agent's Autonomy Score and the verifiable facts behind it.","description":"The vault agent's Autonomy Score and the verifiable facts behind it. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/passport":{"get":{"operationId":"get_agent_passport","summary":"The vault agent's portable machine-readable passport (identity, surfaces, receipts).","description":"The vault agent's portable machine-readable passport (identity, surfaces, receipts). Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/rwa-performance":{"get":{"operationId":"get_rwa_performance","summary":"The vault's real cost basis and return per RWA position since purchase (USD and SOL).","description":"The vault's real cost basis and return per RWA position since purchase (USD and SOL). Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/shadow-vs-brain":{"get":{"operationId":"get_shadow_vs_brain","summary":"The shadow language model's daily calls measured against the deterministic brain.","description":"The shadow language model's daily calls measured against the deterministic brain. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/agent/recent-cycles":{"get":{"operationId":"get_recent_cycles","summary":"The latest distribution cycles with their on-chain transaction receipts.","description":"The latest distribution cycles with their on-chain transaction receipts. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"How many recent cycles to return (default 5).","schema":{"type":"integer","minimum":1,"maximum":20}}]}},"/api/agent/monthly-reports":{"get":{"operationId":"get_monthly_reports","summary":"The agent's closed books, one per month, each committed on-chain.","description":"The agent's closed books, one per month, each committed on-chain. Read-only public data; nothing here moves funds, requires auth, or exposes personal data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"months","in":"query","required":false,"description":"How many recent months to return (default 12).","schema":{"type":"integer","minimum":1,"maximum":24}}]}}}}