{"openapi":"3.1.0","info":{"title":"MarginPad Free Crypto API","version":"1.0.0","description":"Free, keyless, CORS-enabled crypto market-data API. Live prices, OHLC candles, a scored futures screener, funding rates, open interest, long/short ratios, liquidations, an economic calendar, the Fear & Greed index, top coins, global market stats, DeFi TVL, trading calculators, and a free paper-trading REST API for testing bots. No API key. No sign-up. 60 requests/minute per IP. Every response uses the envelope { ok, data, error, ts }.","contact":{"name":"MarginPad","url":"https://marginpad.io/free-crypto-api/"},"license":{"name":"Free for public use"}},"servers":[{"url":"https://marginpad.io","description":"Production"}],"externalDocs":{"description":"Full manual with curl / JS / Python examples","url":"https://marginpad.io/free-crypto-api/"},"tags":[{"name":"Market data","description":"Live prices, candles, symbols"},{"name":"Derivatives","description":"Funding, open interest, long/short, liquidations (aggregated across exchanges)"},{"name":"Screener","description":"Technically scored USDT-perp screener"},{"name":"Macro","description":"Economic calendar, Fear & Greed, global stats, DeFi TVL"},{"name":"Calculators","description":"Liquidation price, position size, PnL, risk/reward, take-profit"},{"name":"Paper trading","description":"Free simulated trading REST API (test your bot with no real money). Auth via X-API-Key."},{"name":"Meta","description":"Status & version"}],"paths":{"/api/v1/ping":{"get":{"tags":["Meta"],"summary":"API status & version","description":"Health check. Returns service name, version, rate limit, and the list of available endpoints. Use this to confirm the API is reachable.","responses":{"200":{"description":"ok"}}}},"/api/v1/price":{"get":{"tags":["Market data"],"summary":"Live price for one coin","description":"Current price for a single symbol, aggregated across Binance/Bybit/OKX/Gate. Use when a user asks \"what is the price of X\".","parameters":[{"name":"symbol","in":"query","required":true,"description":"Coin ticker, e.g. BTC, ETH, SOL (no USDT suffix needed).","schema":{"type":"string"},"example":"BTC"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/prices":{"get":{"tags":["Market data"],"summary":"Live prices for major coins","description":"Batch snapshot of the top coins in one call (BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX).","responses":{"200":{"description":"ok"}}}},"/api/v1/klines":{"get":{"tags":["Market data"],"summary":"OHLC candles","description":"Historical candlesticks for a symbol. Use for charts, backtests, and indicator math.","parameters":[{"name":"symbol","in":"query","required":true,"description":"Coin ticker, e.g. BTC.","schema":{"type":"string"},"example":"BTC"},{"name":"interval","in":"query","required":false,"description":"Minutes per candle: 1, 5, 15, 60, 240, or 1440 (1d).","schema":{"type":"string"},"example":"60"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/symbols":{"get":{"tags":["Market data"],"summary":"Tradable symbols","description":"List of ~500 liquid USDT-perpetual symbols by volume. Use to validate a ticker or populate a picker.","responses":{"200":{"description":"ok"}}}},"/api/v1/screener":{"get":{"tags":["Screener"],"summary":"Scored futures screener","description":"Top USDT-perps with a 0-100 technical score, verdict (bullish/bearish), RSI, MACD, trend, and an ATR-based trade setup (entry/SL/TP) when decisive. Use when a user asks \"what looks bullish/bearish right now\".","responses":{"200":{"description":"ok"}}}},"/api/v1/funding":{"get":{"tags":["Derivatives"],"summary":"Funding rates","description":"Perp funding rates across ~160 pairs (Coinglass-aggregated majors + Bybit long tail). Positive = longs pay shorts.","responses":{"200":{"description":"ok"}}}},"/api/v1/open-interest":{"get":{"tags":["Derivatives"],"summary":"Open interest","description":"Open interest (USD) across ~160 pairs. Rising OI + rising price = new money entering.","responses":{"200":{"description":"ok"}}}},"/api/v1/long-short":{"get":{"tags":["Derivatives"],"summary":"Long/short ratio","description":"Aggregated long vs short account ratio for major coins. Crowd positioning.","responses":{"200":{"description":"ok"}}}},"/api/v1/liquidations":{"get":{"tags":["Derivatives"],"summary":"Liquidations","description":"Aggregated 24h liquidation totals per coin (longs vs shorts) across all exchanges.","responses":{"200":{"description":"ok"}}}},"/api/v1/calendar":{"get":{"tags":["Macro"],"summary":"Crypto economic calendar","description":"FOMC, CPI, NFP, options expiry and crypto milestones with exact UTC timestamps. Omit params for the upcoming window; pass year for a full year incl. history.","parameters":[{"name":"year","in":"query","required":false,"description":"Full year 2023-2027 for the whole year incl. past events. Omit for the upcoming window.","schema":{"type":"string"},"example":"2026"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/fear-greed":{"get":{"tags":["Macro"],"summary":"Fear & Greed index","description":"Current crypto Fear & Greed value (0-100) and classification.","responses":{"200":{"description":"ok"}}}},"/api/v1/coins":{"get":{"tags":["Macro"],"summary":"Top coins by market cap","description":"Top ~250 coins: price, market cap, 1h/24h/7d change, sparkline. Optional category filter.","parameters":[{"name":"cat","in":"query","required":false,"description":"CoinGecko category id, e.g. layer-1, decentralized-finance-defi, meme-token, artificial-intelligence.","schema":{"type":"string"},"example":"layer-1"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/global":{"get":{"tags":["Macro"],"summary":"Global market stats","description":"Total market cap, 24h volume, BTC dominance.","responses":{"200":{"description":"ok"}}}},"/api/v1/trending":{"get":{"tags":["Macro"],"summary":"Trending coins","description":"Currently trending coins (CoinGecko search trending).","responses":{"200":{"description":"ok"}}}},"/api/v1/defi":{"get":{"tags":["Macro"],"summary":"DeFi TVL overview","description":"Total DeFi TVL, top chains, biggest protocols, largest stablecoins (DefiLlama-aggregated).","responses":{"200":{"description":"ok"}}}},"/api/v1/calc/liquidation":{"get":{"tags":["Calculators"],"summary":"Liquidation price","description":"Compute the liquidation price for a leveraged position.","parameters":[{"name":"entry","in":"query","required":true,"description":"Entry price.","schema":{"type":"string"},"example":"60000"},{"name":"leverage","in":"query","required":true,"description":"Leverage, e.g. 10.","schema":{"type":"string"},"example":"10"},{"name":"side","in":"query","required":false,"description":"long or short.","schema":{"type":"string"},"example":"long"},{"name":"mmr","in":"query","required":false,"description":"Maintenance margin rate in percent (default 0.5).","schema":{"type":"string"},"example":"0.5"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/calc/position-size":{"get":{"tags":["Calculators"],"summary":"Position size","description":"Risk-based position size from account balance, risk %, entry and stop.","parameters":[{"name":"balance","in":"query","required":true,"description":"Account balance.","schema":{"type":"string"},"example":"10000"},{"name":"risk","in":"query","required":true,"description":"Risk percent of balance, e.g. 1.","schema":{"type":"string"},"example":"1"},{"name":"entry","in":"query","required":true,"description":"Entry price.","schema":{"type":"string"},"example":"60000"},{"name":"stop","in":"query","required":true,"description":"Stop-loss price.","schema":{"type":"string"},"example":"58000"},{"name":"leverage","in":"query","required":false,"description":"Optional leverage for margin required.","schema":{"type":"string"},"example":"10"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/calc/pnl":{"get":{"tags":["Calculators"],"summary":"PnL / ROI","description":"Profit/loss and ROI for a position.","parameters":[{"name":"entry","in":"query","required":true,"description":"Entry price.","schema":{"type":"string"},"example":"60000"},{"name":"exit","in":"query","required":true,"description":"Exit price.","schema":{"type":"string"},"example":"63000"},{"name":"side","in":"query","required":false,"description":"long or short.","schema":{"type":"string"},"example":"long"}],"responses":{"200":{"description":"ok"}}}},"/api/v1/calc/risk-reward":{"get":{"tags":["Calculators"],"summary":"Risk / reward","description":"Risk-reward ratio from entry, stop and target.","responses":{"200":{"description":"ok"}}}},"/api/v1/calc/take-profit":{"get":{"tags":["Calculators"],"summary":"Take-profit price","description":"Take-profit price for a target ROI/RR.","responses":{"200":{"description":"ok"}}}},"/api/bot/v1/price":{"get":{"tags":["Paper trading"],"summary":"Paper price (keyless)","description":"Fill price used by the paper-trading engine.","parameters":[{"name":"symbol","in":"query","required":true,"description":"Coin ticker.","schema":{"type":"string"},"example":"BTC"}],"responses":{"200":{"description":"ok"}}}},"/api/bot/v1/open":{"post":{"tags":["Paper trading"],"summary":"Open a paper position","description":"Open a simulated position. Auth: header X-API-Key (mint one at POST /api/bot/key while signed in). Body: {symbol, side, margin, leverage, sl?, tp?}. margin $1-100000, leverage 1-1000.","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"side":{"type":"string","enum":["long","short"]},"margin":{"type":"number"},"leverage":{"type":"number"},"sl":{"type":"number"},"tp":{"type":"number"}},"required":["symbol","side","margin","leverage"]}}}},"responses":{"200":{"description":"ok"}}}},"/api/bot/v1/close":{"post":{"tags":["Paper trading"],"summary":"Close a paper position","description":"Close (fully or partially) a simulated position. Auth: X-API-Key. Body: {id, pct?}. pct 1-100 for a partial close.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"ok"}}}},"/api/bot/v1/positions":{"get":{"tags":["Paper trading"],"summary":"List paper positions","description":"Open simulated positions with live mark price and unrealized PnL. Auth: X-API-Key.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"ok"}}}},"/api/bot/v1/account":{"get":{"tags":["Paper trading"],"summary":"Paper account","description":"Simulated account balance and stats. Auth: X-API-Key.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"ok"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Only for paper-trading endpoints. Mint a key at POST /api/bot/key while signed in. Data endpoints need no auth."}},"schemas":{"Envelope":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"ts":{"type":"integer","description":"Server unix ms"}},"required":["ok","ts"]}}}}