MarginPad API

Tudo o que o site sabe, em JSON: preços e candles ao vivo, um screener com score, funding, interesse aberto, long/short, liquidações medidas em oito exchanges, um calendário econômico - sem chave. Além de uma Bot API de paper trading completa para testar um bot de trading em tempo real, com preços reais e sem dinheiro de verdade, um servidor MCP remoto para que um assistente de IA use tudo isso nativamente, uma especificação OpenAPI 3.1 e clientes de arquivo único em Python e JavaScript.

Dados de mercado - /api/v1/*, sem chave

Toda resposta usa o envelope { ok, data, ts } ({ ok:false, error:{ code, message } } em caso de falha) com CORS ativado, então uma página de navegador pode chamá-la diretamente. 60 requisições por minuto por IP sem chave. Envie uma X-API-Key grátis (de /trading-api/) nas mesmas chamadas e elas passam a ser medidas pela sua chave - 120 por minuto, 600 no Premium. Manual completo com exemplos: /free-crypto-api/.

curl "https://marginpad.io/api/v1/price?symbol=BTC"
curl "https://marginpad.io/api/v1/screener"
curl -H "X-API-Key: mpb_..." "https://marginpad.io/api/v1/klines?symbol=ETH&interval=15"   # counts against your key, not your IP

Bot API de paper trading - /api/bot/v1/* e /api/bot/v2/*

Aponte um bot de trading para preços reais ao vivo e liquide cada trade em dólares simulados: margem isolada, alavancagem de até 1000×, liquidações confirmadas em candles de 1 minuto, taxas taker e funding cobrados como em uma exchange. Entre com um e-mail e gere uma chave em /trading-api/; as posições ficam na sua conta e contam para as tabelas da temporada. Os formatos de resposta da v1 são congelados; a v2 é a mesma API no envelope { ok, data, ts }. Auth: X-API-Key.

A documentação completa, o quickstart, os códigos de erro e as notas de confiabilidade (idempotência, ETags, o WebSocket) estão em /trading-api/. Cada mudança é registrada em /api/changelog (JSON em /api/changelog?format=json); a versão atual é a 2.4.0.

MCP - use no Claude, no ChatGPT ou no Cursor

Adicione https://marginpad.io/mcp como servidor MCP remoto (Streamable HTTP). As ferramentas de dados de mercado não precisam de chave; defina o header X-API-Key para as ferramentas de paper trading. 23 ferramentas: get_price, get_klines, get_markets, get_screener, get_funding, get_open_interest, get_liquidations, get_fear_greed, get_economic_calendar, calc_liquidation, calc_position_size, paper_balance, paper_positions, paper_trades, paper_open, paper_close, paper_sltp, paper_modify_order, paper_fees, paper_report, paper_limit_order, paper_orders, paper_cancel_order.

Clientes - um arquivo, zero dependências

marginpad.py (Python 3.8+, só urllib; websockets opcional para o stream) e marginpad.js (Node 18+ ou um navegador). Ambos cobrem dados de mercado, todas as chamadas de paper trading, polling com ETag, back-off de 429, o stream WebSocket e a verificação de assinatura de webhook.

from marginpad import MarginPad
mp = MarginPad("mpb_...")                              # key from /trading-api/
print(mp.price("BTC"))                                 # keyless market data
r = mp.open("BTC", "long", margin_usd=100, leverage=10, trail_pct=1.5,
            client_order_id="sig-1403")                # a retry can never open twice
print(r["position"]["liq_price"], mp.report()["skill"])

Calculadoras - /api/*, JSON puro

Uma API JSON pública e gratuita para os cálculos de futuros cripto mais comuns. Sem chave de API, sem cadastro, com CORS - chame de qualquer lugar.

Base URL   https://marginpad.io/api
Method     GET
Auth       none
CORS       enabled (Access-Control-Allow-Origin: *)
Format     JSON   (also under /api/v1/calc/* in the { ok, data, ts } envelope)

Preço de liquidação

{
  "side": "long",
  "liquidationPrice": 54300,
  "distancePct": -9.5
}

Tamanho da posição (por risco)

{ "positionSize": 0.041667, "notional": 2500, "riskAmount": 50, "marginRequired": 250 }

PnL / ROI / ROE

{ "pnl": 3000, "roiPct": 10, "roePct": 100 }

Risco / retorno

{ "riskRewardRatio": 3, "riskPerUnit": 2000, "rewardPerUnit": 6000, "breakevenWinRatePct": 25 }

Alvo de take-profit

{ "targetExitPrice": 64500, "priceMovePct": 7.5 }

Notas

Os cálculos usam a estimativa de margem isolada e são apenas para fins educacionais, não são aconselhamento financeiro. Os valores excluem taxas da exchange e funding. A API é fornecida grátis e no estado em que se encontra. Se você construir algo com ela, um link para marginpad.io é bem-vindo. Os dados de mercado são gratuitos para uso público, atribuição bem-vinda; a Bot API é um simulador e nunca toca em fundos reais. Apenas educacional, não é aconselhamento financeiro.