Market Liquidation Chart API
Returns OHLC-style aggregated liquidation data for a token on a specific exchange.
Category: Finance And Markets
Price
$0.0162 per successful call ≈ 61 calls with the $1 signup credit.
Input schema is not available in the local snapshot. Call inspect first; fill body and queryParams as required and replace any pathParams placeholders before running.
Discover
curl https://keepbal.com/apis/v1/discover -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"query":"Market Liquidation Chart"}'Inspect
curl https://keepbal.com/apis/v1/inspect -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"publicId":"surf/market-liquidation-chart"}'curl
curl https://keepbal.com/apis/v1/surf/market-liquidation-chart \
-H 'Authorization: Bearer YOUR_KEEPBAL_KEY' \
-H 'Content-Type: application/json' \
-d '{}'MCP run_tool
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run_tool",
"arguments": {
"tool": "surf/market-liquidation-chart",
"input": {}
}
}
}Python
import json, os, requests
# Inspect first and replace input_data with the required parameters.
input_data = json.loads("{}")
response = requests.post(
"https://keepbal.com/apis/v1/surf/market-liquidation-chart",
headers={"Authorization": "Bearer " + os.environ["KEEPBAL_API_KEY"]},
json=input_data,
)
response.raise_for_status()
print(response.json())Errors and billing
Failed provider calls are not charged. HTTP 400 invalid_request means invalid JSON or parameters, including missing pathParams. HTTP 401 missing_api_key or invalid_api_key means authentication is required. HTTP 402 insufficient_credits means insufficient balance; top up before retrying. HTTP 503 provider_unavailable means the provider is unavailable. A pending run can settle later; poll GET /apis/v1/runs/{id} instead of starting another execution.
Frequently asked questions
How much does this API cost?
$0.0162 per successful call
How do I start?
Create a KeepBal account with $1 free credit, obtain an API key, and inspect this tool before running it.
Related tools
| Tool | What it returns | Price |
|---|---|---|
| Exchange Funding History | Returns historical funding rate records for a perpetual contract. | $0.0081 per successful call |
| Exchange Long Short Ratio | Returns historical long/short ratio for a perpetual contract. | $0.0081 per successful call |
| Exchange Perp | Returns a perpetual futures snapshot for a trading pair: funding rate, open interest, mark/index price. | $0.0081 per successful call |
| Hyperliquid Account | Returns a wallet's full portfolio across perps, spot, vaults, and staking in one call, with a perp+vault equity roll-up (totalvalueusd is the total-equity figure a dashboard header should show, vs the perp-only equity on /performance and /positions). | $0.0324 per successful call |
| Hyperliquid Candles | Returns market OHLCV candles for charting and trade-review overlays, ordered by opentime ascending. | $0.0324 per successful call |
| Hyperliquid Fills | Returns a wallet's individual fills (fill-level executions), newest first by default, with realized PnL, fees, and direction (crossed=true marks a taker fill that took liquidity). | $0.0324 per successful call |