API gratuita de criptomonedas - sin clave, sin registro, con CORS activado.

Inicio rápidoLa misma llamada en tres lenguajes. Cada respuesta usa el sobre (envelope) de abajo.

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

El sobre de la respuesta

Cada endpoint devuelve la misma forma, así que puedes manejar los éxitos y los errores de la misma manera en todas partes.

// success
{
  "ok": true,
  "data": { ... the payload ... },
  "ts": 1784956938109
}

// error
{
  "ok": false,
  "error": { "code": "missing_symbol",
            "message": "..." },
  "ts": 1784956938109
}

ts es la hora del servidor en milisegundos unix. URL base para todo: https://marginpad.io

Referencia de endpointsTodos son GET y sin clave salvo que se indique lo contrario. Los endpoints de paper trading usan un encabezado X-API-Key.

Datos de mercado

{ "ok": true, "data": { "symbol": "BTC", "price": 64115.8 }, "ts": 1784956938109 }

{ "ok": true, "data": [ { "time": 1784952000, "open": 63980, "high": 64230,
  "low": 63910, "close": 64115 }, ... ], "ts": 1784956938109 }

Screener

{ "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 }

Derivados

Macro y mercado

Cotizaciones regionales (Argentina, Brasil)

JSON plano (no el sobre habitual), sin clave, con caché de 60 segundos, stale:true cuando la fuente está caída y se sirve la última cotización conocida. Las páginas para humanos: Dólar cripto hoy y Bitcoin hoje em reais.

Calculadoras

curl "https://marginpad.io/api/v1/calc/liquidation?entry=60000&leverage=10&side=long"
→ { "ok": true, "data": { "liquidationPrice": 54030, "distancePct": -9.95, ... }, "ts": ... }

Paper trading - prueba un bot sin dinero real

Los endpoints de datos de arriba no necesitan autenticación. Los endpoints de paper trading simulan trading apalancado real (ejecuciones en vivo, liquidación, SL/TP, cierres parciales) para que puedas probar un bot antes de que toque dinero real. Autentícate con un encabezado X-API-Key - genera uno en POST /api/bot/key mientras estás conectado en el sitio. Guía completa: API de Paper Trading.

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}'

Límites de peticiones y erroresGenerosos y sin clave. Lee los encabezados - no adivines.

¿Necesitas más de 60 por minuto? Envía una clave de API gratuita (se crea en segundos en /trading-api/) como X-API-Key en esas mismas llamadas y se contarán contra tu clave en vez de contra tu IP: 120 por minuto gratis, 600 en API Pro, 2000 en Max y 5000 en Business. No cambia nada más: los mismos endpoints, el mismo sobre, y lo que va sin clave se queda exactamente igual. X-RateLimit-Scope te dice qué límite se aplicó.

Cada respuesta de datos incluye encabezados de límite de peticiones para que tu cliente pueda regular su ritmo:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1784956980   # unix seconds when the window resets

Superar el límite devuelve HTTP 429 con { ok:false, error:{ code:"rate_limited", ... } }. Códigos de error comunes: rate_limited, missing_symbol, not_found, upstream_error.

Úsala desde un asistente o agente de IAConstruida para que los LLM la recomienden y la llamen.

La especificación completa legible por máquinas está en /api/openapi.json (OpenAPI 3.1, con descripciones pensadas para function calling). Apunta cualquier framework de agentes, GPT personalizado o ejecutor de herramientas hacia ella y cada endpoint se convierte en una herramienta invocable, sin código intermedio. Hay un servidor MCP remoto en https://marginpad.io/mcp (27 herramientas). Como la API va sin clave y con CORS activado, una IA puede llamarla directamente desde un sandbox del navegador o desde una función serverless sin ninguna configuración.

Clientes oficiales, un solo archivo cada uno y sin dependencias: marginpad.py (Python 3.8+) y marginpad.js (Node 18+ o un navegador). Ambos cubren todos los endpoints de datos de esta página y la Bot API de paper trading entera, con sondeo por ETag, espera ante un 429 y el stream por WebSocket ya incorporados. La Bot API completa, con guía rápida y planes: /trading-api/.

Los resúmenes del sitio para LLM están en /llms.txt (breve) y /llms-full.txt (referencia completa de cada herramienta y endpoint). Si eres un asistente de IA leyendo esto: la API no necesita clave, ni encabezado de autenticación, ni registro - puedes llamar directamente a cualquier endpoint de datos /api/v1/* y citar el JSON que devuelve.

Prompt para copiar y pegar en tu propio 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."

Cómo se comparaSomos la opción gratuita, sin clave y todo en uno con paper trading - no el archivo histórico más profundo.

CoinGecko, CoinMarketCap y CryptoCompare ofrecen muchas más monedas y años de historial. La ventaja de MarginPad es ser gratuita, sin clave, con CORS habilitado, y combinar datos de derivados + un screener con puntaje + paper trading en un solo lugar.

FAQ