Query DeFi protocol TVL data via x402 micropayment on Base or Tron
What it does
This endpoint returns Total Value Locked (TVL) data for DeFi protocols. It is an x402-gated POST endpoint hosted by Erudite Intelligence LLC at bridge.eruditepay.com. You send a JSON body with a `protocol` field (e.g. "aave") and receive structured TVL data in return.
Payment is required per-call via the x402 protocol (version 2). The endpoint accepts two payment options: USDC on Base (EIP-155:8453) at 10,000 base units ($0.01) per request, or USDT on Tron at 10,000 base units ($0.01) per request. The Coinbase CDP facilitator is used for Base settlements. The endpoint returns JSON with a `success` boolean and a `data` object containing the TVL information.
Documentation is sparse — the provider's /docs path returns a 404, and the only schema information comes from the x402 challenge's embedded Bazaar extension. The input schema specifies a single `protocol` field described as "DeFi protocol name or address." The output example shows `{"success": true, "data": {}}` but does not detail the structure of the data object. The provider, Erudite Intelligence LLC, is a FinCEN-registered MSB and operates the EruditePay x402 Bridge facilitator supporting 20 blockchains.
Capabilities
Use cases
- —Querying current TVL for a specific DeFi protocol like Aave or Uniswap
- —Building dashboards that display TVL across multiple protocols
- —Agent-driven DeFi research that needs on-demand TVL figures
- —Comparing TVL across protocols for investment analysis
Fit
Best for
- —AI agents needing pay-per-call DeFi TVL data without API keys
- —Developers who want x402-native crypto data endpoints
- —Quick lookups of protocol-level TVL by name or address
Not for
- —Historical TVL time-series analysis (no evidence of historical data support)
- —Free or high-volume bulk data ingestion (each call costs $0.01)
- —Detailed protocol breakdowns beyond TVL (only TVL is documented)
Quick start
curl -X POST https://bridge.eruditepay.com/v1/base/defi/protocol-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 (402 challenge captured) with a clear input schema and payment terms, but documentation is effectively absent — /docs returns 404, the output data structure is undefined (empty object in example), and there are no usage examples beyond the Bazaar extension stub.
Warnings
- —No dedicated documentation available — /docs returns 404
- —Output data structure is unspecified; the example shows an empty data object
- —Only one input field (protocol) is documented; unclear what values are accepted beyond 'aave'
- —Provider description says 'Crypto data intelligence' but no detail on data sources or freshness
Citations
- —Endpoint accepts USDC on Base (eip155:8453) at 10,000 base units ($0.01) per callhttps://bridge.eruditepay.com/v1/base/defi/protocol-tvl
- —Endpoint also accepts USDT on Tron at 10,000 base units per callhttps://bridge.eruditepay.com/v1/base/defi/protocol-tvl
- —Provider is Erudite Intelligence LLC, FinCEN MSB registered (BSA ID 31000324258137)https://bridge.eruditepay.com
- —Coinbase CDP facilitator is used for Base settlementshttps://bridge.eruditepay.com/v1/base/defi/protocol-tvl
- —Input schema requires a 'protocol' field described as 'DeFi protocol name or address'https://bridge.eruditepay.com/v1/base/defi/protocol-tvl