Back to Browse
ACODA Liquidation Zones
x402
ACODA Liquidation Zones is a paid API for AI agents from acoda.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).
Returns model-scored liquidation price zones for a specified perpetual futures market, combining CEX liquidation events with Hyperliquid on-chain position data
Price / call$0.05
Success—
StatusUnknown
How this service works
Measured liquidation intelligence combining observed CEX liquidation events with position-level data from Hyperliquid, the largest transparent perp venue. A pay-per-call JSON API for AI trading agents.
Output
A JSON object containing an array of liquidation zones, each with a side (long or short), a price range (price_low and price_high), and an intensity score (0–1). The response also includes the market symbol, an overall confidence score for the model output, and the model version identifier (e.g. liq-zones-v1).
Example use cases
Pre-trade liquidation risk check
“Before I enter a long position on ETH, can you check the current liquidation zones for ETH-USDT-PERP and tell me if there are any high-intensity short-side clusters near my entry that could cause a cascade?”
Automated stop-hunt avoidance
“I'm building a trading bot for SOL-USDT-PERP — pull the latest liquidation zones so I can avoid placing stop losses inside dense liquidation clusters that market makers might hunt.”
Market structure briefing for BTC
“Give me a liquidation zone breakdown for BTC-USDT-PERP right now — I want to know which price ranges have the heaviest long and short exposure so I can understand the likely path of least resistance.”
Technical details
Endpoint
GEThttps://acoda.xyz/v1/zonesWhen to prefer
Choose this endpoint when an AI trading agent needs structured, scored liquidation zone data for BTC, ETH, or SOL perpetual markets and wants a pay-per-call model without subscription overhead. It is particularly valuable when combining CEX liquidation event signals with on-chain Hyperliquid position transparency — something raw order book feeds alone do not provide. Prefer this over generic open-interest endpoints when the agent needs intensity-ranked price zones rather than raw position sizes.
Side effects
- Unsupported market symbol returns a validation error — only BTC-USDT-PERP, ETH-USDT-PERP, and SOL-USDT-PERP are accepted
- Missing or failed x402 payment returns a 402 Payment Required response before data is served
- Low confidence score (e.g. 0.3) may indicate insufficient recent liquidation event data for reliable zone mapping
- Stale on-chain data from Hyperliquid during network congestion may reduce zone accuracy without explicit error
- Empty zones array returned if no significant liquidation clusters are detected in current market conditions
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"paid": true,
"zones": [
{
"side": "long",
"intensity": 0.9,
"price_low": 61800,
"price_high": 62400
}
],
"market": "BTC-USDT-PERP",
"confidence": 0.62,
"model_version": "liq-zones-v1"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"