MARGINPAD

Markets Tools Sign in

2 · Endpoints

Authenticate with the X-API-Key header on every call except /price and /klines.

Free Liquidation Data API LIVE DATA

Real-time liquidations aggregated from Binance, Bybit, OKX, BitMEX, Hyperliquid and Bitfinex — the data behind our Rekt feed and Liquidation Heatmap, exposed as free JSON. Comparable data is normally paywalled at $300+/month elsewhere; here it needs no API key at all. Edge-cached and rate-limited, so it comfortably handles polling bots.

# the last liquidations on the market, right now:
curl "https://marginpad.io/api/v1/feed"
# BTC liquidation clusters for your own heatmap:
curl "https://marginpad.io/api/v1/clusters?symbol=BTC"

Attribution appreciated (link marginpad.io) but not required. Coverage is ~70%+ of the market’s liquidation flow — the venues that move price. Educational use; no uptime SLA.

3 · Two-minute quickstart

# price (no key)
curl "https://marginpad.io/api/bot/v1/price?symbol=SOL"

# open a 20x long with $100 margin
curl -X POST "https://marginpad.io/api/bot/v1/open" \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"symbol":"SOL","side":"long","margin_usd":100,"leverage":20}'

# check live P&L
curl "https://marginpad.io/api/bot/v1/positions" -H "X-API-Key: YOUR_KEY"

# close half, let the rest run
curl -X POST "https://marginpad.io/api/bot/v1/close" \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"id":"POSITION_ID","pct":50}'

# python bot skeleton
import requests, time
API = "https://marginpad.io/api/bot"
H = {"X-API-Key": "YOUR_KEY"}

price = requests.get(f"{API}/v1/price", params={"symbol": "BTC"}).json()["price"]
if my_signal(price):  # your strategy here
    r = requests.post(f"{API}/v1/open", headers=H, json={
        "symbol": "BTC", "side": "long", "margin_usd": 50, "leverage": 10,
        "sl": price * 0.97, "tp": price * 1.06,
    }).json()
    print("opened", r["position"]["id"], "liq @", r["position"]["liq_price"])

# node.js bot skeleton
const API = "https://marginpad.io/api/bot";
const H = { "X-API-Key": "YOUR_KEY", "content-type": "application/json" };

const { price } = await (await fetch(`${API}/v1/price?symbol=ETH`)).json();
if (mySignal(price)) {  // your strategy here
  const r = await (await fetch(`${API}/v1/open`, { method: "POST", headers: H,
    body: JSON.stringify({ symbol: "ETH", side: "short", margin_usd: 50, leverage: 10 }) })).json();
  console.log("opened", r.position.id, "liq @", r.position.liq_price);
}

Why test a trading bot on paper first

Backtesting vs paper trading vs going live

Do all three, in that order. The middle step is the one most people skip — and the one that would have saved them.

How the simulator works

FAQ

Is there a free liquidation data / heatmap API?

Yes — MarginPad exposes real-time liquidations aggregated from 6 exchanges as free JSON, no key needed: /api/v1/feed, /api/v1/liquidations/live, /api/v1/liquidations/recent and /api/v1/clusters. Comparable feeds are usually $300+/month. See the "Free Liquidation Data API" section above.

Guides & tutorials

Get your free key ↑