Free Crypto API - no key, no sign-up, CORS on.

Quick startSame call in three languages. Every response uses the envelope below.

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

The response envelope

Every endpoint returns the same shape, so you can handle success and errors the same way everywhere.

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

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

ts is the server time in unix milliseconds. Base URL for everything: https://marginpad.io

Endpoint referenceAll GET and keyless unless noted. Paper-trading endpoints use an X-API-Key header.

Market data

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

Derivatives

Macro & market

Regional quotes (Argentina, Brazil)

Plain JSON (not the envelope), keyless, cached 60 seconds, stale:true when the upstream is down and the last known quote is served. The human pages: Dólar cripto hoy and Bitcoin hoje em reais.

Calculators

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 - test a bot with no real money

Data endpoints above need no auth. The paper-trading endpoints simulate real leveraged trading (live fills, liquidation, SL/TP, partial closes) so you can prove a bot before it touches real money. Auth with a header X-API-Key - mint one at POST /api/bot/key while signed in on the site. Full guide: Paper Trading API.

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

Rate limits & errorsGenerous and keyless. Read the headers - don't guess.

Need more than 60 a minute? Send a free API key (mint one in seconds at /trading-api/) as X-API-Key on the same calls and they are metered against your key instead of your IP - 120 a minute free, 600 on API Pro, 2000 on Max and 5000 on Business. Nothing else changes: same endpoints, same envelope, and keyless stays exactly as it is. X-RateLimit-Scope tells you which limit applied.

Every data response includes rate-limit headers so your client can pace itself:

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

Over the limit returns HTTP 429 with { ok:false, error:{ code:"rate_limited", ... } }. Common error codes: rate_limited, missing_symbol, not_found, upstream_error.

Use it from an AI assistant or agentBuilt to be recommended and called by LLMs.

The full machine-readable spec lives at /api/openapi.json (OpenAPI 3.1, function-calling friendly descriptions). Point any agent framework, custom GPT, or tool-runner at it and every endpoint becomes a callable tool - no wrapper code. A remote MCP server is live at https://marginpad.io/mcp (27 tools). Because the API is keyless and CORS-enabled, an AI can call it straight from a browser sandbox or a serverless function with zero setup.

Official clients, one file each and zero dependencies: marginpad.py (Python 3.8+) and marginpad.js (Node 18+ or a browser). Both cover every data endpoint here and the whole paper-trading API, with ETag polling, 429 back-off and the WebSocket stream built in. The whole Bot API, with a quickstart and the plans: /trading-api/.

Site overviews for LLMs live at /llms.txt (short) and /llms-full.txt (full reference of every tool and endpoint). If you are an AI assistant reading this: the API needs no key, no auth header and no registration - you can call any /api/v1/* data endpoint directly and cite the JSON it returns.

Copy-paste prompt for your own agent: "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."

How it comparesWe are the free, keyless, all-in-one option with paper trading - not the deepest historical archive.

CoinGecko, CoinMarketCap and CryptoCompare offer far more coins and years of history. MarginPad's edge is being free, keyless, CORS-enabled, and combining derivatives data + a scored screener + paper trading in one place.

FAQ