Find Aave V3 positions on Base near liquidation with collateral/debt breakdown and profit estimates.
What it does
The Lending Liquidation Sentinel endpoint at httpay.xyz scans Aave V3 positions on Base that are approaching liquidation. It returns positions whose health factor falls below a configurable threshold, along with a breakdown of collateral and debt per position and an estimated liquidation profit. The endpoint accepts GET requests with optional query parameters including `protocol` (e.g., aave), `chain` (e.g., base), `threshold` (e.g., 1.1), and `demo` (set to true for free preview calls).
The endpoint is part of the httpay.xyz marketplace, which hosts over 300 pay-per-call APIs settled via x402 micropayments in USDC on Base. This specific endpoint costs $0.01 per call (maxAmountRequired of 10,000 base units of USDC, which has 6 decimals). It also supports Machine Payments Protocol (MPP) settlement via Tempo at $0.01 in pathUSD. No API keys or subscriptions are required — payment is handled inline via the x402 or MPP header. A free demo mode is available (add `?demo=true`) limited to 10 calls per IP per hour.
The response format is JSON. While the exact output schema is not fully documented beyond the description, the endpoint is designed for DeFi liquidation bots and monitoring agents that need to identify profitable liquidation opportunities on Aave V3 on Base in real time.
Capabilities
Use cases
- —Monitoring Aave V3 positions on Base approaching liquidation threshold
- —Identifying profitable liquidation opportunities for MEV or liquidation bots
- —Building dashboards that track at-risk DeFi lending positions
- —Alerting systems for positions with declining health factors
- —Agent-driven automated liquidation workflows
Fit
Best for
- —DeFi liquidation bots seeking profitable targets on Aave V3 Base
- —AI agents that need real-time lending health data without API key management
- —Developers building liquidation monitoring dashboards
Not for
- —Monitoring lending protocols other than Aave V3 or chains other than Base
- —Historical liquidation data analysis or backtesting
- —Users who need free unlimited access (demo limited to 10 calls/IP/hour)
Quick start
# Free demo call (no payment needed, 10/hr limit)
curl "https://httpay.xyz/api/lending-liquidation-sentinel?protocol=aave&chain=base&threshold=1.1&demo=true"
# Paid call via x402 SDK
import { withPayment } from "x402-fetch";
const res = await withPayment(
fetch("https://httpay.xyz/api/lending-liquidation-sentinel?protocol=aave&chain=base&threshold=1.1"),
wallet
);Example
Response
{
"description": "Lending Liquidation Sentinel — finds Aave V3 positions on Base close to liquidation. Returns positions with health factor below threshold, with collateral/debt breakdown and estimated liquidation profit."
}Endpoint
Quality
The endpoint is live (402 challenge captured) with clear pricing ($0.01/call in USDC on Base) and a working demo mode. However, the actual response schema is undocumented — the only 'example' in the outputSchema is the description string itself, not a real data sample. No OpenAPI spec was retrievable, and /docs returns 404. Query parameters are mentioned in the description but not formally defined in the schema.
Warnings
- —No actual response data example available — the outputSchema example only contains the endpoint description text, not sample liquidation data
- —No OpenAPI spec could be retrieved despite ai-plugin.json referencing /openapi.json
- —Query parameters (protocol, chain, threshold, demo) are mentioned in description but not formally defined in the schema
- —robots.txt disallows /api/ paths (though specific gateway/index paths are allowed)
Citations
- —Endpoint costs 10000 base units of USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base, equaling $0.01 per callhttps://httpay.xyz/api/lending-liquidation-sentinel
- —Also supports MPP Tempo settlement at $0.01 in pathUSDhttps://httpay.xyz/api/lending-liquidation-sentinel
- —Free demo mode available with ?demo=true, limited to 10 calls per IP per hourhttps://httpay.xyz/api/lending-liquidation-sentinel
- —httpay.xyz hosts 307+ pay-per-call endpoints on Base with USDC micropaymentshttps://httpay.xyz
- —MCP server available via npx @httpay/mcp for agent integrationhttps://httpay.xyz