{"data":{"service":"protocol-health-oracle","version":"1.0.0","endpoints":[{"path":"/health","method":"GET","auth":false,"description":"Liveness check."},{"path":"/v1/status","method":"GET","auth":false,"description":"Service catalog."},{"path":"/v1/scoreboard","method":"GET","auth":false,"description":"Public teaser: protocol name, score, and verdict only (no components/history) across the full tracked universe — auto-ingested from DefiLlama (TVL > $1M) plus curated protocols.","params":{"limit":"Optional. Rows to return (default 100, max 2000).","offset":"Optional. Pagination offset (default 0).","category":"Optional. Filter by DefiLlama category, e.g. \"Liquid Staking\".","min_tvl":"Optional. Only protocols with TVL >= this USD amount."}},{"path":"/v1/protocols","method":"GET","auth":true,"description":"All tracked protocols with their latest health score and verdict.","params":{"limit":"Optional. Rows to return (default 100, max 2000).","offset":"Optional. Pagination offset (default 0).","category":"Optional. Filter by DefiLlama category.","min_tvl":"Optional. Only protocols with TVL >= this USD amount."}},{"path":"/v1/health/:slug","method":"GET","auth":true,"description":"Latest health score for one protocol: components (GitHub activity, TVL trend, treasury), source details, and score history.","params":{"slug":"Required (path). The protocol's defillama_slug, e.g. lido.","history":"Optional. Number of historical scores to include (default 10, max 100)."}},{"path":"/v1/protocols","method":"POST","auth":true,"description":"Track a new protocol. Scored immediately from live GitHub + DeFiLlama data.","body":{"required":["name","github_repo","defillama_slug"],"properties":{"name":"Display name, e.g. \"Lido\".","github_repo":"owner/repo, e.g. lidofinance/core.","defillama_slug":"DeFiLlama protocol slug, e.g. lido.","chain":"Optional. Default \"ethereum\".","treasury_address":"Optional. On-chain treasury address to score (Etherscan balance)."}}},{"path":"/v1/refresh","method":"POST","auth":true,"description":"Force an immediate live re-score of all tracked protocols."},{"path":"/v1/ingest","method":"POST","auth":true,"description":"Force an immediate sync of the tracked-protocol universe from DefiLlama (TVL > $1M). Runs automatically once/day; use this to trigger it on demand."}]},"meta":{"timestamp":"2026-09-03T07:35:46.149Z"}}