TVL breakdown by chain for any DeFi protocol via x402-paid API on Base
What it does
The `/api/protocol/tvl-decompose` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence and DeFi analytics to autonomous AI agents. This specific endpoint decomposes a protocol's Total Value Locked (TVL) by chain, allowing callers to understand how a protocol's liquidity is distributed across different blockchains. It is priced at $0.50 per call, paid in USDC on Base via the x402 protocol.
DeFi Shield covers 11 categories including DeFi intelligence, wallet profiling, MEV analysis, NFT risk, cross-chain comparisons, and more. All endpoints follow the same pattern: POST requests with an x402 payment header containing a USDC payment token. Free GET requests to any endpoint path return discovery metadata including an `llm_usage_prompt` for agent integration. The service also exposes a health endpoint (`/api/health`) listing all endpoints and pricing, an analytics endpoint (`/api/analytics`), and an A2A discovery card at `/.well-known/agent-card.json`.
The TVL decompose endpoint sits within the Protocol Intelligence category alongside related endpoints for protocol risk scoring, governance centralization analysis, multi-protocol comparison, token emission modeling, oracle dependency risk, and bridge risk assessment. No OpenAPI schema or detailed request/response documentation was found during crawling, so the exact request parameters and response format must be inferred from the endpoint's purpose and the platform's general patterns.
Capabilities
Use cases
- —Determine how a DeFi protocol's TVL is distributed across multiple chains before making investment decisions
- —Compare chain-level liquidity concentration to assess protocol diversification risk
- —Feed TVL decomposition data into autonomous agent workflows for portfolio rebalancing
- —Monitor shifts in protocol TVL across chains over time for early warning signals
- —Combine with protocol risk and governance endpoints for comprehensive protocol due diligence
Fit
Best for
- —AI agents performing automated DeFi protocol analysis
- —Developers building cross-chain DeFi dashboards
- —Risk analysts evaluating protocol chain concentration
- —Autonomous trading agents needing real-time TVL intelligence
Not for
- —Historical TVL time-series analysis (endpoint appears to return current snapshot only)
- —Non-DeFi or traditional finance TVL metrics
- —Users who need free unlimited access — every call costs $0.50 in USDC
Quick start
# Discover endpoint metadata (free)
curl https://defi-shield-hazel.vercel.app/api/protocol/tvl-decompose
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/protocol/tvl-decompose \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"protocol": "aave"}'Example
Request
{
"protocol": "aave"
}Endpoint
Quality
The endpoint is live (402 challenge confirmed) and the landing page provides clear pricing and category context, but no OpenAPI schema, detailed parameter documentation, or example responses were found. The request/response formats are inferred from the endpoint name and platform patterns.
Warnings
- —No OpenAPI or JSON schema available for request or response validation
- —No dedicated docs page found (returns 404)
- —Request body parameters are inferred — actual required fields may differ
- —x402 challenge returned empty object, so payment details (amount, asset, network) could not be independently verified from the probe
- —Response format is entirely unknown — example_response_json is null
Citations
- —TVL decompose endpoint is priced at $0.50 per callhttps://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints across 11 categorieshttps://defi-shield-hazel.vercel.app
- —Payment is in USDC via x402 protocol on Basehttps://defi-shield-hazel.vercel.app
- —Free GET discovery is available on every endpoint with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Endpoint description: TVL breakdown by chainhttps://defi-shield-hazel.vercel.app