Query DeFi TVL data for Base protocols via x402-paid POST endpoint
What it does
This endpoint provides DeFi Total Value Locked (TVL) data for protocols on the Base network. It is operated by Erudite Intelligence LLC and accessed via the x402 payment protocol. Callers send a POST request with a JSON body specifying a DeFi protocol name (e.g., "aave"), and receive TVL intelligence data in return. Each call costs 0.01 USDC (10,000 base units on 6-decimal USDC) on Base (eip155:8453), or equivalently 0.01 USDT on Tron. Payment is facilitated through the EruditePay x402 Bridge, which supports Coinbase CDP settlement on Base and direct Tron settlement.
The endpoint returns JSON with a `success` boolean and a `data` object. The schema is minimal — the only documented input field is `protocol` (a string representing the DeFi protocol name or address). No detailed output schema or field-level documentation is provided beyond the example stub `{"success": true, "data": {}}`. The provider describes the broader service as "Crypto data intelligence" but does not elaborate on what specific TVL metrics or breakdowns are included in the response.
The endpoint is live and returns a valid x402 v2 challenge on unauthenticated POST requests. The EruditePay Bridge facilitator is a FinCEN MSB-registered entity (BSA ID 31000324258137) operating a non-custodial settlement model. Documentation at docs.eruditepay.com is referenced but the /docs path on the bridge itself returns a 404, so detailed API docs are not currently accessible from the crawled material.
Capabilities
Use cases
- —Querying current TVL for specific DeFi protocols on Base
- —Building dashboards that display protocol-level TVL metrics
- —Automated agents comparing TVL across DeFi protocols
- —Portfolio or risk analysis tools needing on-chain TVL data
- —Research workflows requiring programmatic DeFi data access
Fit
Best for
- —Agents needing per-call DeFi TVL data without API key subscriptions
- —Developers building Base-ecosystem DeFi analytics
- —Micropayment-based crypto data retrieval
Not for
- —Historical time-series TVL data (no evidence of historical support)
- —Multi-chain TVL aggregation beyond Base (endpoint path is Base-specific)
- —Free or high-volume bulk data retrieval (each call costs $0.01)
Quick start
curl -X POST https://bridge.eruditepay.com/v1/base/defi/tvl \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"protocol": "aave"}'Example
Request
{
"protocol": "aave"
}Response
{
"data": {},
"success": true
}Endpoint
Quality
The endpoint is live with a valid x402 v2 challenge and has a basic schema with input/output examples, but the output example is an empty stub, no detailed docs are accessible, and the actual data fields returned are unknown. Pricing is clear ($0.01 USDC per call) but the value of the response cannot be assessed without seeing real output.
Warnings
- —Output example is a stub with empty data object — actual response fields are unknown
- —docs.eruditepay.com is referenced but /docs on the bridge returns 404; no detailed API documentation was accessible
- —No OpenAPI spec or detailed schema for the response payload
- —The only documented input field is 'protocol' — unclear what valid values are accepted beyond 'aave'
Citations
- —Endpoint returns x402 v2 challenge with 0.01 USDC on Base (10000 base units, 6 decimals) and 0.01 USDT on Tronhttps://bridge.eruditepay.com/v1/base/defi/tvl
- —Provider is Erudite Intelligence LLC, FinCEN MSB registered with BSA ID 31000324258137https://bridge.eruditepay.com
- —EruditePay Bridge is a non-custodial x402 facilitator supporting 20 blockchainshttps://bridge.eruditepay.com
- —Settlement fee is 0.5% per successful settlement, verification is freehttps://bridge.eruditepay.com
- —Input schema accepts a 'protocol' field described as 'DeFi protocol name or address'https://bridge.eruditepay.com/v1/base/defi/tvl