liquidmap guides
Free order book walls API.
The largest buy and sell walls for BTC and 5 other coins, summed from up to 15 order books across 10 exchanges, as JSON with no key and no sign-up.
Updated



How to use it
Endpoint GET https://liquidmap.io/api/muros-publicos?par=BTCUSDT
- No key, no sign-up, no cookies. GET only.
- Parameter: par (optional, default BTCUSDT): BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT, BNBUSDT, DOGEUSDT. Any other value → 400.
- Rate limit: 60 requests per minute per IP. Over it: 429 with Retry-After (seconds). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. The snapshot refreshes every ~30 s: asking more than twice a minute per pair brings nothing new.
- Open CORS (Access-Control-Allow-Origin: *): you can call it from the browser on any site.
- Errors: 400 invalid pair · 429 rate limit · 503 “sin datos” (the engine has no fresh snapshot: nothing is ever made up).
Working examples
curl
curl -s "https://liquidmap.io/api/muros-publicos?par=BTCUSDT"JavaScript
// browser or Node 18+ (.mjs file)
const r = await fetch("https://liquidmap.io/api/muros-publicos?par=BTCUSDT");
const d = await r.json();
const m = d.venta[0]; // the largest sell wall
console.log(`Sell wall: ${m.cantidad} BTC at ${m.precio} USDT (${m.distancia_pct} %), ${m.exchange}`);Python
# Python 3.8+, nothing to install
import json, urllib.request
url = "https://liquidmap.io/api/muros-publicos?par=BTCUSDT"
req = urllib.request.Request(url, headers={"User-Agent": "my-app/1.0"}) # without your own User-Agent, Cloudflare answers 403
with urllib.request.urlopen(req, timeout=10) as r:
d = json.load(r)
m = d["compra"][0] # the largest buy wall
print(f"Buy wall: {m['cantidad']} BTC at {m['precio']} USDT ({m['distancia_pct']} %), {m['exchange']}")Real response right now
{
"par": "BTCUSDT",
"precio": 63742.47,
"t": 1794940930714.9983,
"exchanges": 15,
"rango": 5,
"compra": [
{
"lado": "compra",
"precio": 63595,
"desde": 63595,
"hasta": 63660,
"cantidad": 1427.3755,
"usd": 90773946,
"distancia_pct": -0.231,
"exchange": "OKX perp",
"exchanges": 15
},
{
"lado": "compra",
"precio": 63525,
"desde": 63515,
"hasta": 63580,
"cantidad": 1128.2259,
"usd": 71670551,
"distancia_pct": -0.341,
"exchange": "OKX perp",
"exchanges": 14
}
],
"venta": [
{
"lado": "venta",
"precio": 63795,
"desde": 63735,
"hasta": 63800,
"cantidad": 1561.4247,
"usd": 99611088,
"distancia_pct": 0.082,
"exchange": "Bybit perp",
"exchanges": 15
},
{
"lado": "venta",
"precio": 63955,
"desde": 63940,
"hasta": 64005,
"cantidad": 1242.038,
"usd": 79434540,
"distancia_pct": 0.333,
"exchange": "Bybit perp",
"exchanges": 14
}
],
"perfil": {
"paso_pct": 0.25,
"compra": [
167195819,
148855724,
88132492,
43222453
],
"venta": [
176597480,
132764333,
56096731,
44073911
]
},
"edad_s": 3
}Snapshot at 18:42:10 UTC (BTCUSDT), trimmed: 2 walls per side and 4 profile bands here; the full response has up to 8 and 20.
What it returns
| Field | Type | What it is |
|---|---|---|
par | string | The requested pair (BTCUSDT…). |
precio | number | Mid price of the summed book at snapshot time (USDT). |
t | number | Snapshot time, in UTC milliseconds (epoch). |
edad_s | number | Seconds from the snapshot to your request. |
exchanges | number | How many order books were summed (spot and perpetual count separately; BTC: up to 15 books from 10 exchanges). |
rango | number | Distance from price that is scanned, in % (5 = ±5 %). |
compra / venta | array | Up to 8 walls per side, largest first. Compra = buy orders below price; venta = sell orders above. |
· precio | number | Price level with the most orders in the wall (USDT). |
· desde / hasta | number | Summed band: ±0.05 % around that level. |
· cantidad | number | Size in the coin (BTC, ETH…). |
· usd | number | Size in US dollars. |
· distancia_pct | number | Distance to price, in % (negative = below). |
· exchange | string | The book contributing most to that wall (e.g. “OKX perp”). |
· exchanges | number | How many books have orders in that band. |
perfil | object | Liquidity in USD by distance bands from price: paso_pct (0.25 %) and 20 bands per side (compra downwards, venta upwards). |
Terms of use
Free, commercial use included, on one condition: credit the source with a visible link to liquidmap.io (“Data: liquidmap.io”) wherever you show the data. No availability guarantee. This is market data, not investment advice.
More information
Use it on your site, bot or spreadsheet crediting liquidmap.io.
What it is for
To show on your site, your Telegram or Discord bot, your spreadsheet or your dashboard where the big liquidity is waiting right now: price, size, distance and the exchange contributing most to each wall. The same snapshot is on live BTC walls; for TradingView there is the Pine script with today’s walls and, for an entry or a stop, walls near your price.
Where the data comes from
From the public order books of Binance, OKX, Bybit, Kraken, Bitfinex, Coinbase, Bitstamp, Gemini, Deribit and Gate (spot and perpetual), which liquidmap’s engine reads and sums itself. A wall is the orders within ±0.05 % of its heaviest level, summed across all books; walls are searched within ±5 % of price. The snapshot refreshes about every 30 seconds. If it is missing, the API answers 503: nothing is estimated or filled in.
A wall can be pulled before price gets there or eaten if it does: this is a snapshot of the book, not a forecast. Analysis tool. Not investment advice.
Frequently asked questions
Is it free?
Yes, no key and no sign-up, commercial use included, on one condition: credit “Data: liquidmap.io” with a visible link to liquidmap.io wherever you show the data.
What is the rate limit?
60 requests per minute per IP. Over it, the API answers 429 with Retry-After. The snapshot changes about every 30 seconds, so there is no need to ask more often.
Which pairs are available?
BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT, BNBUSDT and DOGEUSDT, with the par parameter.
Is there history?
No: it returns the snapshot of right now. If you store each response, you build your own history.
Can I call it from the browser?
Yes: open CORS (Access-Control-Allow-Origin: *), no cookies or credentials.
Is this investment advice?
No. It describes the order book at a moment. It does not say what price will do.
Sources and date
Public order books of Binance, OKX, Bybit, Kraken, Bitfinex, Coinbase, Bitstamp, Gemini, Deribit and Gate, summed by liquidmap’s engine (the same as BTC walls). Analysis tool. Not investment advice.