{"openapi":"3.1.0","info":{"title":"CoinTrader Crypto Intelligence & Telemetry API","description":"Institutional API powering live cryptocurrency analytics, spot liquidity vs perpetual futures basis spread divergence, 1-minute UTC candlestick ingestion, and India VDA tax compliance metrics.","version":"1.0.0","contact":{"name":"CoinTrader API Support","url":"https://cointraders.in","email":"support@cointraders.in"}},"servers":[{"url":"https://cointraders.in","description":"Production Global Edge CDN"}],"paths":{"/api/market/ticker":{"get":{"summary":"Retrieve live market ticker telemetry and basis spreads","description":"Returns real-time Binance Spot prices, Perpetual Futures mark prices, basis spread (premium/discount), and 8-hour funding rates for single tokens or bulk Top 50 assets.","operationId":"getMarketTicker","parameters":[{"name":"symbol","in":"query","required":false,"description":"Cryptocurrency trading pair symbol (e.g. BTCUSDT, ETHUSDT, SOLUSDT, PEPEUSDT). Defaults to BTCUSDT.","schema":{"type":"string","default":"BTCUSDT"}},{"name":"bulk","in":"query","required":false,"description":"Pass true to receive live ticker and basis telemetry for all 50 top market assets in a single batch.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful market telemetry response","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"number","description":"Live Spot price in USDT"},"change24h":{"type":"number","description":"24-hour percentage change"},"high24h":{"type":"number"},"low24h":{"type":"number"},"volume24h":{"type":"number"},"markPrice":{"type":"number","description":"USDⓈ-M Perpetual Futures Mark Price"},"indexPrice":{"type":"number"},"fundingRate":{"type":"number","description":"Current 8-hour funding rate (e.g. 0.0001 = 0.01%)"},"nextFundingTime":{"type":"string","description":"Countdown to next settlement (e.g. 03h 45m)"},"basis":{"type":"number","description":"Mark Price minus Spot Price"},"basisPercent":{"type":"number","description":"Basis percentage divergence"}}}}}}}}},"/api/market/candles":{"get":{"summary":"Retrieve historical OHLCV candlestick bars","description":"Queries 1-minute, 5-minute, 15-minute, 1-hour, 4-hour, or 1-day candlestick history served directly from Edge database storage.","operationId":"getCandlestickBars","parameters":[{"name":"symbol","in":"query","required":true,"description":"Trading pair symbol (e.g. BTCUSDT, ETHUSDT)","schema":{"type":"string","default":"BTCUSDT"}},{"name":"mode","in":"query","required":false,"description":"Market type: spot or perpetual","schema":{"type":"string","enum":["spot","perpetual"],"default":"spot"}},{"name":"interval","in":"query","required":false,"description":"Timeframe interval","schema":{"type":"string","enum":["1m","5m","15m","1h","4h","1d","1w","1M"],"default":"15m"}},{"name":"limit","in":"query","required":false,"description":"Number of historical bars to retrieve (up to 300)","schema":{"type":"integer","default":90}}],"responses":{"200":{"description":"Array of chronological candlestick bars","content":{"application/json":{"schema":{"type":"object","properties":{"candles":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Bar open timestamp in UTC seconds"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"isComplete":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"type":"string"},"status":{"type":"string"},"latencyMs":{"type":"number"},"lastSyncUTC":{"type":"string"}}}}}}}}}}},"/api/agent/browse":{"get":{"summary":"Natural language agentic market intelligence query","description":"Designed specifically for autonomous LLM agents (ChatGPT, Claude, Perplexity, Gemini). Returns dense, token-efficient markdown or JSON with live prices, basis spreads, 8h funding yields, and tax metrics.","operationId":"agentBrowseMarket","parameters":[{"name":"coin","in":"query","required":false,"description":"Coin symbol or slug (e.g. btc, bitcoin, eth, sol, pepe, or all). Defaults to btc.","schema":{"type":"string","default":"btc"}},{"name":"format","in":"query","required":false,"description":"Output format: markdown (token-optimized) or json.","schema":{"type":"string","enum":["markdown","json"],"default":"markdown"}}],"responses":{"200":{"description":"High-density structured summary for LLM context windows","content":{"text/markdown":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object"}}}}}}}}}