⚛️ Planck Agentic Discovery Active

🔍 Agentic Discovery & Search

Smart discovery and capability inspection allowing AI agents to search and inspect protocols without token context bloat.

• GET /api/discover?q=query&engine=all&limit=20 — Example: /api/discover?q=aave&limit=5
• GET /api/metadata/:protocol — Example: /api/metadata/ekubo
• GET /api/pools/top?minTvl=100000&limit=10 — Top Yield Opportunities
• GET /api/coverage — Measured success rates per chain and data type

🤖 Dynamic Continuous Monitoring Watchlist

Allows AI agents to dynamically subscribe and unsubscribe protocols to the background cron worker without editing configurations.

• GET /api/watchlist — View Active Monitored Watchlist
• POST /api/watchlist — Register protocol: {"type": "yield", "protocol": "lido"}
• DELETE /api/watchlist/:protocol?type=yield — Unregister protocol

🛡️ Security & Exploit Protection Engine

Hides the 99 protocols that DefiLlama's dead-adapter registry flags as hacked, insolvent or shut down.

• GET /api/discover?status=active — Default: Only active, operational protocols
• GET /api/protocols/deprecated?limit=10 — Decommissioned & Exploit Blacklist Directory

1. Total Value Locked (TVL)

Calculates and caches on-chain TVL with token and chain distribution (3,579 TVL adapters).

• GET /api/tvl/:protocol — Example: /api/tvl/pangolin
• GET /api/tvl/:protocol?refresh=true — Force re-fetch from blockchain and refresh cache
• GET /api/list/tvl?limit=25 — List TVL protocols (Paginated)

2. Yields & APY Rates

Liquidity pool APY and reward metrics, served from cache once fetched (1,024 yield adapters).

• GET /api/yields/:protocol — Example: /api/yields/lido
• GET /api/list/yields?limit=25 — List Yield protocols (Paginated)

3. Volume, Fees & Revenue Metrics

24h DEX volume, protocol fees, user revenue, and token emissions.

• GET /api/dimensions/:type/:protocol?chain=name — Example: /api/dimensions/dexs/ekubo

4. Historical Market Trends & Timeseries

Continuous historical analytics and rolling time windows for AI agents.

• GET /api/history/tvl/:protocol?days=30 — Historical TVL time-series
• GET /api/history/pools/:poolId?days=30 — Pool APY & TVL history
• GET /api/history/dimensions/:type/:protocol?days=30 — Historical volume & fee metrics

System Status & Health

GET /api/health • Status: Operational