{"openapi":"3.0.0","info":{"title":"VAULT-4 API","version":"1.0.0","description":"Public read-only data + paid premium strategy endpoint for the VAULT-4 fund-of-vaults on Hyperliquid.","guidance":"Free endpoints expose live VAULT-4 fund state (positions, portfolio, metrics, history, on-chain contract). The single paid x402 endpoint — GET /api/strategy/premium, $0.05 USDC on Base — returns current vault allocations + ROE, the market-sentiment overlay, the full candidate-vault list, and the AI's ranked top picks."},"x-discovery":{"ownershipProofs":["0xe9d98e42daf5a4103da549e9befa59a37f3834d013b3cdc7e1527dcdf715d0b17fe3d5b8285e4899160cbf49b8413cdc13cfd9e1483d8b9e870fa5566a4e61401c","0xbfdb2eb4cf50b8835a5cd093a96f30312340994b402268e14b8489822d540f1b2d19f84a2168928265c063f275faead677bc90f2c7f31263ab33ce8443ee00ed1b"]},"servers":[{"url":"https://vault-4-1042359757530.europe-west1.run.app"}],"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"OK"}}}},"/api/positions":{"get":{"summary":"Current vault positions"}},"/api/portfolio":{"get":{"summary":"Aggregated portfolio summary"}},"/api/portfolio/live":{"get":{"summary":"Live portfolio (HL clearinghouse)"}},"/api/metrics":{"get":{"summary":"Platform metrics: TVL, PnL %, win rate, max drawdown"}},"/api/history":{"get":{"summary":"Paginated transaction history","parameters":[{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"pageSize","in":"query","schema":{"type":"integer"}}]}},"/api/contract":{"get":{"summary":"On-chain Vault4Fund contract state"}},"/api/activity":{"get":{"summary":"Recent on-chain deposits/withdrawals (all wallets, ~90d)"}},"/api/strategy":{"get":{"summary":"Free public strategy summary"}},"/api/strategy/premium":{"get":{"summary":"Paid (x402) — current allocations, sentiment overlay, full candidate list, and top picks","parameters":[{"name":"refresh","in":"query","required":false,"description":"Bypass the 5-minute snapshot cache and rebuild from live upstream data.","schema":{"type":"boolean"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC","payTo":"0x60A5d9Eae0a5c3Ec0b2C163C659055B5fA7045A1"},"responses":{"200":{"description":"Premium strategy snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"fund":{"type":"object"},"currentAllocations":{"type":"array","items":{"type":"object"}},"marketSentiment":{"type":"object"},"candidates":{"type":"array","items":{"type":"object"}},"candidateCount":{"type":"integer"},"topPicks":{"type":"array","items":{"type":"object"}},"topPicksGeneratedAt":{"type":"string"},"updatedAt":{"type":"string"}}}}}},"402":{"description":"Payment required — x402 challenge in the Payment-Required header / response body"}}}},"/.well-known/x402":{"get":{"summary":"x402 payable-endpoints manifest"}}}}