Guias do liquidmap
API grátis de paredes do livro de ofertas.
As maiores paredes de compra e venda de BTC e mais 5 criptos, somadas de até 15 livros de 10 exchanges, em um JSON sem chave nem cadastro.
Atualizado em



Como usar
Endereço GET https://liquidmap.io/api/muros-publicos?par=BTCUSDT
- Sem chave, sem cadastro e sem cookies. Só GET.
- Parâmetro: par (opcional, padrão BTCUSDT): BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT, BNBUSDT, DOGEUSDT. Outro valor → 400.
- Limite de uso: 60 pedidos por minuto por IP. Acima disso: 429 com Retry-After (segundos). Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. A foto é renovada a cada ~30 s: pedir mais de 2 vezes por minuto e por par não traz nada novo.
- CORS aberto (Access-Control-Allow-Origin: *): dá para chamar do navegador em qualquer site.
- Erros: 400 par inválido · 429 limite · 503 «sin datos» (o motor não tem uma foto recente: nada é inventado).
Exemplos que funcionam
curl
curl -s "https://liquidmap.io/api/muros-publicos?par=BTCUSDT"JavaScript
// navegador ou Node 18+ (arquivo .mjs)
const r = await fetch("https://liquidmap.io/api/muros-publicos?par=BTCUSDT");
const d = await r.json();
const m = d.venta[0]; // a maior parede de venda
console.log(`Parede de venda: ${m.cantidad} BTC a ${m.precio} USDT (${m.distancia_pct} %), ${m.exchange}`);Python
# Python 3.8+, sem instalar nada
import json, urllib.request
url = "https://liquidmap.io/api/muros-publicos?par=BTCUSDT"
req = urllib.request.Request(url, headers={"User-Agent": "meu-app/1.0"}) # sem User-Agent próprio, a Cloudflare responde 403
with urllib.request.urlopen(req, timeout=10) as r:
d = json.load(r)
m = d["compra"][0] # a maior parede de compra
print(f"Parede de compra: {m['cantidad']} BTC a {m['precio']} USDT ({m['distancia_pct']} %), {m['exchange']}")Resposta real de agora
{
"par": "BTCUSDT",
"precio": 63778.38,
"t": 1794940814621.4016,
"exchanges": 15,
"rango": 5,
"compra": [
{
"lado": "compra",
"precio": 63700,
"desde": 63665,
"hasta": 63730,
"cantidad": 1614.4143,
"usd": 102838194,
"distancia_pct": -0.123,
"exchange": "OKX perp",
"exchanges": 15
},
{
"lado": "compra",
"precio": 63635,
"desde": 63600,
"hasta": 63665,
"cantidad": 1354.5016,
"usd": 86193711,
"distancia_pct": -0.225,
"exchange": "OKX perp",
"exchanges": 14
}
],
"venta": [
{
"lado": "venta",
"precio": 63825,
"desde": 63770,
"hasta": 63835,
"cantidad": 1359.3617,
"usd": 86761259,
"distancia_pct": 0.073,
"exchange": "Bybit perp",
"exchanges": 14
},
{
"lado": "venta",
"precio": 64025,
"desde": 63990,
"hasta": 64055,
"cantidad": 1351.3163,
"usd": 86518027,
"distancia_pct": 0.387,
"exchange": "Bybit perp",
"exchanges": 14
}
],
"perfil": {
"paso_pct": 0.25,
"compra": [
187299437,
147951617,
73938505,
46457255
],
"venta": [
172545517,
131493038,
74810119,
48741736
]
},
"edad_s": 116
}Foto das 18:40:14 UTC (BTCUSDT), recortada: aqui 2 paredes por lado e 4 faixas de perfil; a resposta completa traz até 8 e 20.
O que retorna
| Campo | Tipo | O que é |
|---|---|---|
par | string | O par pedido (BTCUSDT…). |
precio | number | Preço médio do livro somado no momento da foto (USDT). |
t | number | Hora da foto, em milissegundos UTC (epoch). |
edad_s | number | Segundos desde a foto até o seu pedido. |
exchanges | number | Quantos livros de ofertas foram somados (spot e perpétuo contam separado; BTC: até 15 livros de 10 exchanges). |
rango | number | Distância do preço analisada, em % (5 = ±5 %). |
compra / venta | array | Até 8 paredes por lado, da maior para a menor. Compra = ordens abaixo do preço; venta = acima. |
· precio | number | Nível com mais ordens da parede (USDT). |
· desde / hasta | number | Faixa somada: ±0,05 % em torno desse nível. |
· cantidad | number | Tamanho na moeda (BTC, ETH…). |
· usd | number | Tamanho em dólares. |
· distancia_pct | number | Distância do preço, em % (negativa = abaixo). |
· exchange | string | O livro que mais contribui para essa parede (ex.: «OKX perp»). |
· exchanges | number | Quantos livros têm ordens nessa faixa. |
perfil | object | Liquidez em USD por faixas de distância do preço: paso_pct (0,25 %) e 20 faixas por lado (compra para baixo, venta para cima). |
Condição de uso
Grátis, inclusive para uso comercial, com uma condição: cite a fonte com um link visível para liquidmap.io («Dados: liquidmap.io») onde mostrar os dados. Sem garantia de disponibilidade. São dados de mercado, não recomendação de investimento.
Mais informações
Use no seu site, bot ou planilha citando liquidmap.io.
Para que serve
Para mostrar no seu site, no seu bot de Telegram ou Discord, na sua planilha ou no seu painel onde a liquidez grande está esperando agora: preço, tamanho, distância e a exchange que mais contribui em cada parede. A mesma foto está em paredes do livro de BTC; para o TradingView há o script Pine com as paredes de agora e, para uma entrada ou um stop, paredes perto do seu preço.
De onde vêm os dados
Dos livros de ofertas públicos de Binance, OKX, Bybit, Kraken, Bitfinex, Coinbase, Bitstamp, Gemini, Deribit e Gate (spot e perpétuo), que o motor do liquidmap lê e soma. Uma parede são as ordens a menos de ±0,05 % do seu nível mais carregado, somadas entre todos os livros; elas são procuradas a ±5 % do preço. A foto é renovada a cada ~30 segundos. Se faltar, a API responde 503: nada é estimado nem preenchido.
Uma parede pode ser retirada antes de o preço chegar ou consumida se ele chegar: é uma foto do livro, não uma previsão. Ferramenta de análise. Não é recomendação de investimento.
Mais páginas grátis em português
- Heatmap de liquidez do BTC grátis: as últimas 2 horas do livro, minuto a minuto.
- Paredes do livro de ofertas de BTC: as maiores ordens limitadas agora, em 10 exchanges.
- CVD de BTC: spot vs perpétuo: 1 h, 4 h e 24 h.
- Alternativa ao Bookmap para cripto: comparação honesta, com fonte e data.
- Paredes do livro no seu TradingView: script Pine grátis com as paredes de agora.
- Paredes perto do seu preço: as paredes mais próximas acima e abaixo da sua entrada ou do seu stop.
- Liquidações reais vs. heatmap estimado: o que foi liquidado de verdade em 24 h, com as paredes reais do livro.
Comparações honestas, com fonte e data: liquidmap vs TradingLite · liquidmap vs Bookmap · liquidmap vs CoinGlass · liquidmap vs ExoCharts · liquidmap vs TensorCharts · liquidmap vs aggr.
Perguntas frequentes
É grátis?
Sim, sem chave nem cadastro, inclusive para uso comercial, com uma condição: citar «Dados: liquidmap.io» com um link visível para liquidmap.io onde mostrar os dados.
Qual é o limite?
60 pedidos por minuto por IP. Acima disso, a API responde 429 com Retry-After. A foto muda a cada ~30 segundos, então não precisa pedir mais.
Quais pares tem?
BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT, BNBUSDT e DOGEUSDT, com o parâmetro par.
Tem histórico?
Não: retorna a foto de agora. Se você guardar cada resposta, monta o seu próprio histórico.
Dá para chamar do navegador?
Sim: CORS aberto (Access-Control-Allow-Origin: *), sem cookies nem credenciais.
É recomendação de investimento?
Não. Descreve o livro de ofertas em um momento. Não diz o que o preço vai fazer.
Fontes e data
Livros de ofertas públicos de Binance, OKX, Bybit, Kraken, Bitfinex, Coinbase, Bitstamp, Gemini, Deribit e Gate, somados pelo motor do liquidmap (os mesmos de paredes do livro de BTC). Ferramenta de análise. Não é recomendação de investimento.