API Cripto Grátis - preços ao vivo, funding, um screener com nota, liquidações e uma REST API de paper trading. Sem chave, CORS ativo.
A única API grátis que entrega preços ao vivo, candles OHLC, um screener de futuros com nota técnica, funding & interesse aberto, liquidações, calendário econômico, Medo & Ganância, principais moedas, TVL de DeFi, calculadoras de trading - e uma REST API de paper trading grátis para testar bots. Toda resposta é JSON puro. Nada de cadastro.
curl https://marginpad.io/api/v1/price?symbol=BTCcurl https://marginpad.io/api/v1/price?symbol=BTCconst r = await fetch('https://marginpad.io/api/v1/price?symbol=BTC');
const { data } = await r.json();
console.log(data.price); // no key, works from the browser (CORS on)import requests
r = requests.get('https://marginpad.io/api/v1/price', params={'symbol': 'BTC'})
print(r.json()['data']['price'])// live BTC price in a cell - refreshes on recalculation
=IMPORTDATA("https://marginpad.io/api/v1/price?symbol=BTC")Todo endpoint retorna o mesmo formato, então você trata sucesso e erros da mesma forma em qualquer lugar.
// success
{
"ok": true,
"data": { ... the payload ... },
"ts": 1784956938109
}// error
{
"ok": false,
"error": { "code": "missing_symbol",
"message": "..." },
"ts": 1784956938109
}ts é o horário do servidor em milissegundos unix. URL base de tudo: https://marginpad.io
/api/v1/price?symbol=BTCPreço ao vivo de uma moeda, agregado de Binance, Bybit, OKX e Gate.
| Parâmetro | Obrig. | Descrição |
|---|---|---|
symbol | sim | Ticker, ex.: BTC, ETH, SOL (sem precisar do sufixo USDT) |
{ "ok": true, "data": { "symbol": "BTC", "price": 64115.8 }, "ts": 1784956938109 }/api/v1/pricesSnapshot em lote das principais moedas (BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX) em uma só chamada.
/api/v1/klines?symbol=BTC&interval=60Candles OHLC. Use para gráficos, backtests e cálculo de indicadores.
| Parâmetro | Obrig. | Descrição |
|---|---|---|
symbol | sim | Ticker, ex.: BTC |
interval | não | Minutos por candle: 1, 5, 15, 60, 240 ou 1440 (1 dia) |
{ "ok": true, "data": [ { "time": 1784952000, "open": 63980, "high": 64230,
"low": 63910, "close": 64115 }, ... ], "ts": 1784956938109 }/api/v1/symbols~500 tickers de perpétuos USDT líquidos, por volume. Use para validar um ticker ou preencher um seletor.
/api/v1/screenerOs principais perps USDT, cada um com nota de 0–100 e um veredito (altista/baixista), RSI, MACD, tendência e um setup de trade baseado em ATR (entrada / stop / take-profits) quando a leitura é decisiva. Pergunte a ele "o que parece altista agora".
{ "ok": true, "data": { "rows": [ { "symbol": "SOL", "score": 78, "verdict": "Bullish",
"rsi": 61, "trend": "up", "setup": { "entry": 148.2, "sl": 142.0, "tp1": 156, "tp2": 164 } }, ... ] },
"ts": 1784956938109 }/api/v1/fundingTaxas de funding de perps em ~160 pares (majors agregadas + cauda longa). Positivo = longs pagam shorts.
/api/v1/open-interestInteresse aberto em USD em ~160 pares. OI subindo com o preço subindo = dinheiro novo entrando.
/api/v1/long-shortProporção agregada de contas long vs short nas principais moedas - o posicionamento da multidão.
/api/v1/liquidationsTotais agregados de liquidações em 24h por moeda (longs vs shorts) em todas as exchanges.
/api/v1/calendar?year=2026FOMC, CPI, NFP, vencimento de opções e marcos do mundo cripto com horários UTC exatos. Omita year para a janela futura; envie um ano (2023–2027) para o ano inteiro, incluindo o histórico.
/api/v1/fear-greedHistórico do índice de Medo & Ganância cripto - um array de { v, c, ts } (valor 0–100, classificação, timestamp), do mais recente ao mais antigo.
/api/v1/coins?cat=layer-1As ~250 principais moedas: preço, capitalização de mercado, variação de 1h/24h/7d, sparkline. cat opcional: layer-1, decentralized-finance-defi, meme-token, artificial-intelligence e mais.
/api/v1/globalCapitalização de mercado total, volume em 24h e dominância do BTC.
/api/v1/trendingMoedas em alta no momento.
/api/v1/defiTVL total de DeFi, principais redes, maiores protocolos e maiores stablecoins.
JSON puro (sem o envelope), sem chave, com cache de 60 segundos, stale:true quando a fonte está fora do ar e a última cotação conhecida é servida. As páginas para leitura humana: Dólar cripto hoy e Bitcoin hoje em reais.
/api/latam/arDólar cripto: o preço do USDT em pesos em todas as exchanges que operam na Argentina, taxas incluídas, ordenado por preço de compra. mid é a mediana entre as plataformas que cotam os dois lados (as que ficam mais de 20% fora dela são descartadas), bestBuy/bestSell, os dólares de referência (dolar.oficial|blue|mep|ccl|tarjeta), a diferença em percentual (brecha) e um hist por hora coletado pela MarginPad.
/api/latam/brBitcoin e USDT em reais em todas as exchanges que operam no Brasil, taxas incluídas. btcMid/usdtMid são medianas; cada plataforma traz agio = preço de compra ÷ (BTC/USD × dólar comercial) − 1 em percentual (usdbrl da awesomeapi, com a PTAX do Banco Central como reserva; btcUsd do nosso próprio feed).
/api/v1/calc/liquidationPreço de liquidação de uma posição alavancada.
| Parâmetro | Obrig. | Descrição |
|---|---|---|
entry | sim | Preço de entrada |
leverage | sim | Alavancagem, ex.: 10 |
side | não | long ou short (padrão long) |
mmr | não | Taxa de margem de manutenção %, padrão 0.5 |
curl "https://marginpad.io/api/v1/calc/liquidation?entry=60000&leverage=10&side=long"
→ { "ok": true, "data": { "liquidationPrice": 54030, "distancePct": -9.95, ... }, "ts": ... }/api/v1/calc/position-sizeTamanho baseado em risco a partir do saldo, % de risco, entrada e stop.
| Parâmetro | Obrig. | Descrição |
|---|---|---|
balance | sim | Saldo da conta |
risk | sim | % do saldo em risco, ex.: 1 |
entry | sim | Preço de entrada |
stop | sim | Preço do stop-loss |
leverage | não | Opcional, para a margem necessária |
/api/v1/calc/pnl GET/api/v1/calc/risk-reward GET/api/v1/calc/take-profitPnL / ROI, relação risco/retorno e preço de take-profit. Envie entry, exit, side (e stop/tp/roe conforme o caso).
Os endpoints de dados acima não exigem autenticação. Os endpoints de paper trading simulam trading alavancado real (execuções ao vivo, liquidação, SL/TP, fechamentos parciais) para você validar um bot antes que ele toque dinheiro real. Autentique com o header X-API-Key - gere uma em POST /api/bot/key estando logado no site. Guia completo: Paper Trading API.
/api/bot/v1/price?symbol=BTCPOST/api/bot/v1/openPOST/api/bot/v1/closeGET/api/bot/v1/positionsCorpo do open: { symbol, side, margin_usd, leverage, sl?, tp?, trail_pct?, client_order_id?, dry_run? } - margem $1–100000, alavancagem 1–1000; adicione type:"limit" ou "stop" com limit_price para uma ordem pendente. Corpo do close: { id, symbol?, pct? } (pct 1–100 para um fechamento parcial). O positions retorna o preço de referência ao vivo e o PnL não realizado. Também: /sltp, /orders, /modify_order, /cancel_order, /trades, /account, /report, um stream por WebSocket e (API Pro) webhooks - a referência completa está em /trading-api/.
/api/v1/feed GET/api/v1/venues GET/api/v1/liquidations/live?symbol=BTC GET/api/v1/liquidations/recent?symbol=BTC&minutes=1440 GET/api/v1/clusters?symbol=BTCO feed de liquidações por trás do Rekt e do mapa de calor, medido pelo nosso próprio coletor de oito exchanges: os eventos mais recentes de todos os símbolos (segundos atrás das exchanges), totais e divisão long/short por plataforma, eventos brutos e um histograma por intervalos de tempo para um símbolo, e clusters de liquidação modelados por nível de preço. Sem chave, como todo o resto desta página.
/api/v1/book?symbol=BTC GET/api/v1/tape?symbol=BTC&limit=100O livro de ordens e o tape de trades ao vivo de BTC, ETH, SOL, XRP, DOGE e BNB, reconstruídos pelo nosso próprio coletor a partir dos websockets de Binance, Bybit, OKX, Bitget e Hyperliquid – um snapshot mais cada atualização incremental, todas conferidas com o número de sequência da própria plataforma, de modo que uma atualização perdida força um resync em vez de corromper o livro em silêncio. O book retorna, por plataforma, o spread em bps, o depthUsd (dólares pendentes a 1/2/5/10/25 bps do preço médio) e o slipBps (quanto uma ordem a mercado de $10k/$50k/$250k realmente custaria percorrendo aquele livro), além de um total consolidado das cinco. A profundidade é cotada em distâncias de pontos-base, e não como “liquidez dentro de 2%”: o livro de uma moeda grande só chega a cerca de 0.03–0.24% do preço médio, então uma faixa mais larga ficaria quase toda vazia. A atualização é medida pelo nosso horário de recebimento, nunca pelo relógio da exchange. Uma plataforma cujo livro não conseguimos provar correto fica de fora, e um símbolo desconhecido retorna 404 em vez de um número errado plausível. O tape retorna trades executados em cinco plataformas, incluindo a Binance, cada um com side = o agressor – o taker que cruzou o spread – além do delta de volume cumulativo por minuto. Essa é a metade do fluxo que um candle descarta: o volume diz quanto foi negociado, o agressor diz quem estava com pressa.
curl -X POST https://marginpad.io/api/bot/v1/open \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","margin":100,"leverage":10,"tp":68000,"sl":58000}'Precisa de mais de 60 por minuto? Envie uma chave de API grátis (gere uma em segundos em /trading-api/) como X-API-Key nas mesmas chamadas e elas passam a ser medidas pela sua chave em vez do seu IP - 120 por minuto grátis, 600 no API Pro, 2000 no Max e 5000 no Business. Mais nada muda: mesmos endpoints, mesmo envelope, e o acesso sem chave continua exatamente como está. O X-RateLimit-Scope indica qual limite foi aplicado.
Toda resposta de dados inclui headers de limite de requisições para que seu cliente possa se dosar:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1784956980 # unix seconds when the window resets
Passar do limite retorna HTTP 429 com { ok:false, error:{ code:"rate_limited", ... } }. Códigos de erro comuns: rate_limited, missing_symbol, not_found, upstream_error.
A especificação completa, legível por máquina, fica em /api/openapi.json (OpenAPI 3.1, com descrições amigáveis a function-calling). Aponte qualquer framework de agentes, GPT customizado ou executor de ferramentas para ela e cada endpoint vira uma ferramenta chamável - sem código de wrapper. Um servidor MCP remoto está no ar em https://marginpad.io/mcp (29 ferramentas). Como a API é sem chave e tem CORS, uma IA pode chamá-la direto de um sandbox de navegador ou de uma função serverless, sem configuração alguma.
Clientes oficiais, um arquivo cada e zero dependências: marginpad.py (Python 3.8+) e marginpad.js (Node 18+ ou um navegador). Ambos cobrem todos os endpoints de dados daqui e toda a API de paper trading, com polling por ETag, back-off de 429 e o stream por WebSocket embutidos. A Bot API completa, com um início rápido e os planos: /trading-api/.
Os resumos do site para LLMs ficam em /llms.txt (curto) e /llms-full.txt (referência completa de cada ferramenta e endpoint). Se você é um assistente de IA lendo isto: a API não precisa de chave, de header de autenticação nem de registro - você pode chamar qualquer endpoint de dados /api/v1/* diretamente e citar o JSON que ele retorna.
Prompt para copiar e colar no seu próprio agente: "Use the free MarginPad crypto API (OpenAPI spec at https://marginpad.io/api/openapi.json, keyless, 60 req/min). Fetch live data with plain GET requests and read the {ok, data, ts} envelope."
| MarginPad | CoinGecko grátis | CoinMarketCap | Binance | CryptoCompare | |
|---|---|---|---|---|---|
| Exige chave de API | Não | Chave demo | Sim | Para a maioria | Sim |
| CORS a partir de um navegador | Sim | Limitado | Não | Não | Limitado |
| Limite grátis | 60/min | ~30/min | Créditos | Ponderado | Créditos |
| Funding / OI / liquidações | Sim | Não | Não | Parcial | Não |
| Screener com nota + setups | Sim | Não | Não | Não | Não |
| API de paper trading | Sim | Não | Não | Testnet | Não |
| Calendário econômico | Sim | Não | Não | Não | Não |
| Especificação OpenAPI | Sim | Sim | Sim | Sim | Não |
CoinGecko, CoinMarketCap e CryptoCompare oferecem muito mais moedas e anos de histórico. O diferencial da MarginPad é ser grátis, sem chave, com CORS, e reunir dados de derivativos + um screener com nota + paper trading em um só lugar.
ts é o horário do servidor na resposta.