{"version":"1.0.0","totalEndpoints":59,"categories":["Quotes","Company Data","Market Data","Financial Statements","Technical Analysis","News & Sentiment","Economic Data","Crypto","Bulk Operations","COT (Commitment of Traders)","Meta","Search & Discovery","Financial Analysis","Calendar Events","Market Status","Alternative Data","Corporate Actions","ETF","Mutual Funds"],"rateLimits":{"FMP":"300 requests per minute","FRED":"120 requests per minute","News":"60 requests per minute"},"cacheInfo":{"enabled":true,"defaultTTL":300,"ttlByType":{"quote":60,"companyProfile":86400,"financialGrowth":3600,"keyMetrics":3600,"news":900,"priceTarget":3600,"socialSentiment":1800,"marketGainers":300,"marketLosers":300,"marketActives":300,"cryptoQuotes":180,"cotSymbolsList":604800,"cotReport":604800,"cotAnalysis":604800,"default":300}},"features":{"pagination":"Available on array responses with ?page=1&limit=100","metadataWrapper":"Add ?meta=true to any endpoint","compression":"gzip enabled on all responses","cors":"Enabled for all origins"},"endpoints":[{"path":"/api/quote/{symbol}","method":"GET","description":"Get real-time stock quote","category":"Quotes","cacheTTL":60,"rateLimit":"300/min","dataSource":"FMP","parameters":{"symbol":{"type":"string","required":true,"description":"Stock ticker symbol"},"meta":{"type":"boolean","required":false,"description":"Include metadata wrapper"}}},{"path":"/api/company-profile/{symbol}","method":"GET","description":"Get detailed company profile","category":"Company Data","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/quotes","method":"GET","description":"Get all tracked stock quotes","category":"Quotes","cacheTTL":60,"rateLimit":"300/min","dataSource":"FMP","pagination":true},{"path":"/api/market-gainers","method":"GET","description":"Get top market gainers","category":"Market Data","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","pagination":true},{"path":"/api/market-losers","method":"GET","description":"Get top market losers","category":"Market Data","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","pagination":true},{"path":"/api/market-actives","method":"GET","description":"Get most active stocks","category":"Market Data","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","pagination":true},{"path":"/api/income-statement/{symbol}","method":"GET","description":"Get income statement data","category":"Financial Statements","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","parameters":{"period":{"type":"string","options":["annual","quarter"],"default":"annual"}}},{"path":"/api/balance-sheet/{symbol}","method":"GET","description":"Get balance sheet data","category":"Financial Statements","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","parameters":{"period":{"type":"string","options":["annual","quarter"],"default":"annual"}}},{"path":"/api/cash-flow/{symbol}","method":"GET","description":"Get cash flow statement","category":"Financial Statements","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","parameters":{"period":{"type":"string","options":["annual","quarter"],"default":"annual"}}},{"path":"/api/technical-indicator/{symbol}","method":"GET","description":"Get technical indicator data","category":"Technical Analysis","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","parameters":{"type":{"type":"string","required":true,"options":["sma","ema","wma","dema","tema","williams","rsi","adx","standardDeviation"]},"timeframe":{"type":"string","required":true,"options":["1min","5min","15min","30min","1hour","4hour","1day","1week","1month"]},"period":{"type":"integer","required":true,"min":2,"max":200},"from":{"type":"date","required":false},"to":{"type":"date","required":false}}},{"path":"/api/news/{symbol}","method":"GET","description":"Get company news","category":"News & Sentiment","cacheTTL":900,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/social-sentiment/{symbol}","method":"GET","description":"Get social sentiment data","category":"News & Sentiment","cacheTTL":1800,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/fred/series/{seriesId}","method":"GET","description":"Get FRED economic series data","category":"Economic Data","cacheTTL":3600,"rateLimit":"120/min","dataSource":"FRED","parameters":{"observation_start":{"type":"date","required":false},"observation_end":{"type":"date","required":false},"frequency":{"type":"string","options":["d","w","bw","m","q","sa","a"]}}},{"path":"/api/crypto-quotes","method":"GET","description":"Get cryptocurrency quotes","category":"Crypto","cacheTTL":180,"rateLimit":"300/min","dataSource":"FMP","pagination":true},{"path":"/api/quotes/bulk","method":"POST","description":"Get quotes for multiple symbols","category":"Bulk Operations","cacheTTL":60,"rateLimit":"300/min","dataSource":"FMP","requestBody":{"symbols":{"type":"array","maxItems":100,"required":true}}},{"path":"/api/company-profiles/bulk","method":"POST","description":"Get company profiles for multiple symbols","category":"Bulk Operations","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP","requestBody":{"symbols":{"type":"array","maxItems":50,"required":true}}},{"path":"/api/cot/symbols","method":"GET","description":"List all available COT futures symbols","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/cot/report/:symbol","method":"GET","description":"Get COT report for a specific futures contract","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"300/min","dataSource":"FMP","parameters":{"symbol":{"type":"string","required":true,"description":"Futures contract symbol (e.g., GC, CL, ES)"}}},{"path":"/api/cot/analysis/:symbol","method":"GET","description":"Get COT analysis with market sentiment for a futures contract","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"300/min","dataSource":"FMP","parameters":{"symbol":{"type":"string","required":true,"description":"Futures contract symbol (e.g., GC, CL, ES)"}}},{"path":"/api/cot/mappings","method":"GET","description":"Get all futures-to-stock mappings","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"unlimited","dataSource":"Local"},{"path":"/api/cot/stocks/:symbol","method":"GET","description":"Get stocks and ETFs related to a futures contract","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"unlimited","dataSource":"Local","parameters":{"symbol":{"type":"string","required":true,"description":"Futures contract symbol (e.g., GC, CL)"}}},{"path":"/api/cot/futures/:stockSymbol","method":"GET","description":"Get futures contracts related to a stock symbol","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"unlimited","dataSource":"Local","parameters":{"stockSymbol":{"type":"string","required":true,"description":"Stock symbol (e.g., XOM, NEM)"}}},{"path":"/api/cot/screener","method":"POST","description":"Screen futures contracts by COT metrics and sentiment","category":"COT (Commitment of Traders)","cacheTTL":604800,"rateLimit":"300/min","dataSource":"FMP","requestBody":{"sector":{"type":"string","required":false,"description":"Filter by sector (energy, metals, agriculture, etc.)"},"minNetLong":{"type":"number","required":false,"description":"Minimum net long positions"},"maxNetLong":{"type":"number","required":false,"description":"Maximum net long positions"},"sentiment":{"type":"string","required":false,"description":"Filter by sentiment (bullish, bearish, neutral)"},"sortBy":{"type":"string","required":false,"description":"Sort field (netLong, netLongPct)"},"limit":{"type":"number","required":false,"description":"Max results (1-100, default 50)"}}},{"path":"/api/meta","method":"GET","description":"This endpoint - lists all available endpoints","category":"Meta","cacheTTL":3600,"rateLimit":"unlimited"},{"path":"/api/openapi.json","method":"GET","description":"OpenAPI 3.0 specification","category":"Meta","cacheTTL":3600,"rateLimit":"unlimited"},{"path":"/api/docs","method":"GET","description":"Interactive API documentation (Swagger UI)","category":"Meta","cacheTTL":3600,"rateLimit":"unlimited"},{"path":"/api/cache-stats","method":"GET","description":"Cache performance statistics","category":"Meta","cacheTTL":0,"rateLimit":"unlimited"},{"path":"/api/stock-screener","method":"GET","description":"Screen stocks based on criteria","category":"Search & Discovery","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","parameters":{"marketCapMoreThan":{"type":"number","required":false},"marketCapLowerThan":{"type":"number","required":false},"priceMoreThan":{"type":"number","required":false},"priceLowerThan":{"type":"number","required":false},"volumeMoreThan":{"type":"number","required":false},"volumeLowerThan":{"type":"number","required":false},"sector":{"type":"string","required":false},"industry":{"type":"string","required":false},"country":{"type":"string","required":false},"exchange":{"type":"string","required":false},"limit":{"type":"number","required":false}}},{"path":"/api/search-cik","method":"GET","description":"Search companies by CIK","category":"Search & Discovery","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP","parameters":{"query":{"type":"string","required":true}}},{"path":"/api/search-cusip","method":"GET","description":"Search companies by CUSIP","category":"Search & Discovery","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP","parameters":{"cusip":{"type":"string","required":true}}},{"path":"/api/search-isin","method":"GET","description":"Search companies by ISIN","category":"Search & Discovery","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP","parameters":{"isin":{"type":"string","required":true}}},{"path":"/api/available-traded","method":"GET","description":"Get list of all traded symbols","category":"Search & Discovery","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/key-executives/{symbol}","method":"GET","description":"Get company key executives","category":"Company Data","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/company-outlook/{symbol}","method":"GET","description":"Get comprehensive company outlook","category":"Company Data","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/shares-float/{symbol}","method":"GET","description":"Get shares float data","category":"Company Data","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/ratios/{symbol}","method":"GET","description":"Get financial ratios","category":"Financial Analysis","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/ratios-ttm/{symbol}","method":"GET","description":"Get TTM financial ratios","category":"Financial Analysis","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/enterprise-values/{symbol}","method":"GET","description":"Get enterprise values","category":"Financial Analysis","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/rating/{symbol}","method":"GET","description":"Get company rating","category":"Financial Analysis","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/dcf/{symbol}","method":"GET","description":"Get discounted cash flow valuation","category":"Financial Analysis","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/sectors-performance","method":"GET","description":"Get current sectors performance","category":"Market Data","cacheTTL":900,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/historical-sectors-performance","method":"GET","description":"Get historical sectors performance","category":"Market Data","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/ipo-calendar","method":"GET","description":"Get upcoming IPOs","category":"Calendar Events","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/dividend-calendar","method":"GET","description":"Get upcoming dividends","category":"Calendar Events","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/splits-calendar","method":"GET","description":"Get upcoming stock splits","category":"Calendar Events","cacheTTL":14400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/economic-calendar","method":"GET","description":"Get economic events calendar","category":"Calendar Events","cacheTTL":3600,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/is-market-open","method":"GET","description":"Check if market is open","category":"Market Status","cacheTTL":60,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/market-hours","method":"GET","description":"Get market trading hours","category":"Market Status","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/treasury-rates","method":"GET","description":"Get current treasury rates","category":"Economic Data","cacheTTL":3600,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/esg-data/{symbol}","method":"GET","description":"Get ESG (Environmental, Social, Governance) data","category":"Alternative Data","cacheTTL":604800,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/social-sentiment-trending","method":"GET","description":"Get trending social sentiment","category":"Alternative Data","cacheTTL":900,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/social-sentiment-changes","method":"GET","description":"Get social sentiment changes","category":"Alternative Data","cacheTTL":900,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/delisted-companies","method":"GET","description":"Get list of delisted companies","category":"Corporate Actions","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/symbol-changes","method":"GET","description":"Get recent symbol changes","category":"Corporate Actions","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/batch-eod-prices","method":"POST","description":"Get batch EOD prices","category":"Bulk Operations","cacheTTL":300,"rateLimit":"300/min","dataSource":"FMP","requestBody":{"date":{"type":"date","required":false},"symbols":{"type":"array","required":false}}},{"path":"/api/profile-bulk","method":"GET","description":"Get all company profiles","category":"Bulk Operations","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/income-statement-bulk","method":"GET","description":"Get bulk income statements","category":"Bulk Operations","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP","parameters":{"year":{"type":"number","required":false},"period":{"type":"string","options":["annual","quarter"],"required":false}}},{"path":"/api/etf-list","method":"GET","description":"Get complete ETF list","category":"ETF","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"},{"path":"/api/mutual-fund-list","method":"GET","description":"Get complete mutual fund list","category":"Mutual Funds","cacheTTL":86400,"rateLimit":"300/min","dataSource":"FMP"}]}