Aggregated liquidity depth analysis for DeFi tokens via x402-paid API on Base.
What it does
The `/api/mev/liquidity-depth` 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 performs aggregated liquidity depth analysis, useful for understanding how much liquidity is available across DEX pools for a given token or trading pair. It is priced at $0.25 per call, paid in USDC on Base via the x402 protocol.
DeFi Shield endpoints follow a consistent pattern: agents send a POST request with an x402 payment header containing a USDC payment token. The x402 facilitator verifies payment on Base, the endpoint processes the request and returns JSON, and payment settles only on a successful response. Every endpoint also supports a free GET request for discovery, returning metadata and an `llm_usage_prompt` describing how to use it.
No OpenAPI schema or detailed documentation was found for this endpoint. The request body likely accepts parameters such as a token address or trading pair, but the exact schema is not documented in the crawled material. The endpoint returned a 402 status on probe, confirming it is live and awaiting x402 payment. Users should consult the free GET discovery endpoint or the agent card at `/.well-known/agent-card.json` for additional usage details.
Capabilities
Use cases
- —Assessing available liquidity before executing a large trade to minimize slippage
- —Evaluating exit feasibility for a DeFi position by checking aggregated pool depth
- —Feeding liquidity data into an autonomous trading agent's routing decisions
- —Comparing liquidity across pools or DEXes for a specific token
- —Pre-trade analysis for MEV-aware execution strategies
Fit
Best for
- —AI trading agents needing real-time liquidity intelligence
- —DeFi portfolio managers evaluating exit routes
- —MEV-aware bots optimizing trade execution across DEX pools
Not for
- —Centralized exchange order book analysis (this covers DEX liquidity only)
- —Free or high-frequency polling use cases (each call costs $0.25 in USDC)
Quick start
# Free discovery (returns schema + llm_usage_prompt)
curl https://defi-shield-hazel.vercel.app/api/mev/liquidity-depth
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/mev/liquidity-depth \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x..."}'Example
Request
{
"address": "0x..."
}Endpoint
Quality
The endpoint is confirmed live (402 challenge captured) and the landing page provides clear pricing and protocol details, but there is no OpenAPI schema, no detailed documentation, no example response, and the request body schema is inferred from sibling endpoints rather than directly documented.
Warnings
- —No OpenAPI or JSON schema available for this endpoint
- —No documentation page found (docs, pricing, README all return 404)
- —Request body schema is inferred from sibling endpoints and may differ
- —Example response is unavailable — actual response structure is unknown
- —x402 challenge body was empty, so payment parameters (amount, asset, network) could not be independently verified from the probe
Citations
- —The endpoint is priced at $0.25 per call and described as 'Aggregated liquidity depth analysis'https://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints selling security intelligence to autonomous AI agents, paid per request with USDC via x402 on Basehttps://defi-shield-hazel.vercel.app
- —Every endpoint supports a free GET request for discovery with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —The endpoint returned HTTP 402 on POST probe, confirming it is livehttps://defi-shield-hazel.vercel.app/api/mev/liquidity-depth