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

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.

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 native MCP server is on the way. 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.

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