API Cripto Grátis - Preços, Funding, Screener e Paper Trading (Sem Chave)
MARGINPAD

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.

Sem chave de APICORS ativo60 req / min grátis120 / min com chave grátisOpenAPI 3.1

API Cripto Grátis - sem chave, sem cadastro, 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=BTC

Início rápidoA mesma chamada em três linguagens. Toda resposta usa o envelope abaixo.

curl https://marginpad.io/api/v1/price?symbol=BTC
const 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")

O envelope da resposta

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

Referência de endpointsTodos são GET e sem chave, salvo indicação. Os endpoints de paper trading usam o header X-API-Key.

Dados de mercado

GET/api/v1/price?symbol=BTC

Preço ao vivo de uma moeda, agregado de Binance, Bybit, OKX e Gate.

ParâmetroObrig.Descrição
symbolsimTicker, ex.: BTC, ETH, SOL (sem precisar do sufixo USDT)
Exemplo de resposta
{ "ok": true, "data": { "symbol": "BTC", "price": 64115.8 }, "ts": 1784956938109 }
GET/api/v1/prices

Snapshot em lote das principais moedas (BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX) em uma só chamada.

GET/api/v1/klines?symbol=BTC&interval=60

Candles OHLC. Use para gráficos, backtests e cálculo de indicadores.

ParâmetroObrig.Descrição
symbolsimTicker, ex.: BTC
intervalnãoMinutos por candle: 1, 5, 15, 60, 240 ou 1440 (1 dia)
Exemplo de resposta
{ "ok": true, "data": [ { "time": 1784952000, "open": 63980, "high": 64230,
  "low": 63910, "close": 64115 }, ... ], "ts": 1784956938109 }
GET/api/v1/symbols

~500 tickers de perpétuos USDT líquidos, por volume. Use para validar um ticker ou preencher um seletor.

Screener

GET/api/v1/screener

Os 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".

Exemplo de resposta
{ "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 }

Derivativos

GET/api/v1/funding

Taxas de funding de perps em ~160 pares (majors agregadas + cauda longa). Positivo = longs pagam shorts.

GET/api/v1/open-interest

Interesse aberto em USD em ~160 pares. OI subindo com o preço subindo = dinheiro novo entrando.

GET/api/v1/long-short

Proporção agregada de contas long vs short nas principais moedas - o posicionamento da multidão.

GET/api/v1/liquidations

Totais agregados de liquidações em 24h por moeda (longs vs shorts) em todas as exchanges.

Macro & mercado

GET/api/v1/calendar?year=2026

FOMC, 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.

GET/api/v1/fear-greed

Histó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.

GET/api/v1/coins?cat=layer-1

As ~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.

GET/api/v1/global

Capitalização de mercado total, volume em 24h e dominância do BTC.

GET/api/v1/trending

Moedas em alta no momento.

GET/api/v1/defi

TVL total de DeFi, principais redes, maiores protocolos e maiores stablecoins.

Cotações regionais (Argentina, Brasil)

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.

GET/api/latam/ar

Dó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.

GET/api/latam/br

Bitcoin 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).

Calculadoras

GET/api/v1/calc/liquidation

Preço de liquidação de uma posição alavancada.

ParâmetroObrig.Descrição
entrysimPreço de entrada
leveragesimAlavancagem, ex.: 10
sidenãolong ou short (padrão long)
mmrnãoTaxa de margem de manutenção %, padrão 0.5
Exemplo
curl "https://marginpad.io/api/v1/calc/liquidation?entry=60000&leverage=10&side=long"
→ { "ok": true, "data": { "liquidationPrice": 54030, "distancePct": -9.95, ... }, "ts": ... }
GET/api/v1/calc/position-size

Tamanho baseado em risco a partir do saldo, % de risco, entrada e stop.

ParâmetroObrig.Descrição
balancesimSaldo da conta
risksim% do saldo em risco, ex.: 1
entrysimPreço de entrada
stopsimPreço do stop-loss
leveragenãoOpcional, para a margem necessária
GET/api/v1/calc/pnl   GET/api/v1/calc/risk-reward   GET/api/v1/calc/take-profit

PnL / ROI, relação risco/retorno e preço de take-profit. Envie entry, exit, side (e stop/tp/roe conforme o caso).

Paper trading - teste um bot sem dinheiro real

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.

GET/api/bot/v1/price?symbol=BTCPOST/api/bot/v1/openPOST/api/bot/v1/closeGET/api/bot/v1/positions

Corpo 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/.

GET/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=BTC

O 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.

GET/api/v1/book?symbol=BTC   GET/api/v1/tape?symbol=BTC&limit=100

O 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.

Abrir uma posição (curl)
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}'

Limites de requisições & errosGenerosos e sem chave. Leia os headers - não adivinhe.

60req / min / IP (sem chave)
120req / min com chave grátis
600req / min no API Pro
*origem CORS

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.

Use a partir de um assistente de IA ou agenteFeita para ser recomendada e chamada por LLMs.

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."

Como se comparaSomos a opção grátis, sem chave e tudo em um, com paper trading - não o arquivo histórico mais profundo.

 MarginPadCoinGecko grátisCoinMarketCapBinanceCryptoCompare
Exige chave de APINãoChave demoSimPara a maioriaSim
CORS a partir de um navegadorSimLimitadoNãoNãoLimitado
Limite grátis60/min~30/minCréditosPonderadoCréditos
Funding / OI / liquidaçõesSimNãoNãoParcialNão
Screener com nota + setupsSimNãoNãoNãoNão
API de paper tradingSimNãoNãoTestnetNão
Calendário econômicoSimNãoNãoNãoNão
Especificação OpenAPISimSimSimSimNã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.

FAQ

É mesmo grátis, sem chave?
Sim. Sem cadastro, sem chave, sem cartão de crédito para qualquer endpoint de dados. 60 requisições por minuto por IP. Só os endpoints de paper trading precisam de uma chave, que você gera de graça.
Posso usar em um produto comercial?
Sim, para uso público/informativo. Faça cache das respostas, respeite o limite de requisições e não apresente os dados como aconselhamento financeiro. Atribuição (um link de volta) é bem-vinda, não obrigatória.
Quão recentes são os dados?
Os preços se atualizam em segundos; os endpoints de derivativos e macro têm cache de borda de alguns segundos a alguns minutos, conforme a fonte. O campo ts é o horário do servidor na resposta.
De onde vêm os dados?
Preços e candles são agregados de Binance, Bybit, OKX e Gate. Funding e interesse aberto são medidos nos endpoints públicos das exchanges, as proporções long/short de contas vêm de Binance, OKX e Bybit, e as liquidações vêm do coletor próprio da MarginPad, com oito exchanges (Binance, Bybit, OKX, Hyperliquid, Gate, HTX, dYdX, Bitfinex). Moedas, estatísticas globais e tendências vêm da CoinGecko; o TVL de DeFi, da DefiLlama. O screener e as calculadoras são calculados do nosso lado.
Como testo um bot de trading?
Aponte seu bot para os endpoints de paper trading (open / close / positions). Ele executa a preços ao vivo com liquidação real e mecânicas de SL/TP, mas sem dinheiro real. Veja o guia da Paper Trading API.
Existe uma especificação OpenAPI / uma IA pode chamá-la?
Sim - /api/openapi.json (OpenAPI 3.1). Ela foi desenhada para function-calling de LLMs e ferramentas de agentes. Um servidor MCP remoto está no ar em https://marginpad.io/mcp (29 ferramentas) - aponte qualquer cliente MCP para ele.
E se eu precisar de um limite maior?
Os 60/min sem chave atendem a maioria dos apps. Se você está construindo algo maior, fale com a gente em hello@marginpad.io.