{ "openapi": "3.0.0", "info": { "version": "1.8.3", "title": "Leeway API", "description": "Our data API provides access to comprehensive data from more than 70 exchanges worldwide, including Xetra, Frankfurt, Euronext Paris and Amsterdam, London LSE, New York and NASDAQ. Coverage includes 100,000+ tickers, 15,000+ ETFs, and 1,000+ forex pairs. We offer fundamental data with up to 20 years of history, closing prices with up to 35 years history, interval price data, and financial forecasts. Forex and crypto quotes are realtime; other instruments are typically 15 minutes delayed. All data is provided in JSON format via a REST API. The base package includes 100,000 request units per day. Sample data sets can be found in the documentation. Included in our free account are 100 daily request units to try out. Your API token can be found on the account page. For questions or concerns, feel free to contact us at kontakt@leeway.tech." }, "servers": [ { "url": "https://api.leeway.tech" } ], "paths": { "/api/v1/public/general/isin/{isin}": { "get": { "tags": [ "General" ], "description": "Resolve an ISIN or name substring to symbol and exchange listings—entry point for the rest of the API. Coverage: 70+ exchanges, 100,000+ tickers, 15,000+ ETFs. Costs 1 request unit per call.", "parameters": [ { "name": "isin", "in": "path", "required": true, "schema": { "type": "string" }, "description": "ISIN (e.g. DE0007164600) or name/code substring (e.g. SAP)", "example": "SAP" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "example": "SAP" }, "Exchange": { "type": "string", "example": "US" }, "Name": { "type": "string", "example": "SAP SE ADR" }, "Type": { "type": "string", "example": "Common Stock" }, "ISIN": { "type": "string", "example": "US8030542042" }, "isPrimary": { "type": "boolean", "example": false }, "previousClose": { "type": "number", "example": 170.3 }, "previousCloseDate": { "type": "string", "example": "2026-06-10" }, "countryName": { "type": "string", "example": "USA" }, "currencyCode": { "type": "string", "example": "USD" } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "Code": { "type": "string", "example": "SAP" }, "Exchange": { "type": "string", "example": "US" }, "Name": { "type": "string", "example": "SAP SE ADR" }, "Type": { "type": "string", "example": "Common Stock" }, "ISIN": { "type": "string", "example": "US8030542042" }, "isPrimary": { "type": "boolean", "example": false }, "previousClose": { "type": "number", "example": 170.3 }, "previousCloseDate": { "type": "string", "example": "2026-06-10" }, "countryName": { "type": "string", "example": "USA" }, "currencyCode": { "type": "string", "example": "USD" } } }, "xml": { "name": "main" } } } } } } } }, "/api/v1/public/general/mainstock/{isin}": { "get": { "tags": [ "General" ], "description": "Search database by ISIN and get the stock details for further queries.", "parameters": [ { "name": "isin", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "apitoken", "in": "query", "type": "string" } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/general/symbols/{exchange}": { "get": { "tags": [ "General" ], "description": "Query for all securities available in the database for the respective exchange. Returns symbols for further queries.", "parameters": [ { "name": "exchange", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "Common Stock | ETF | FUND", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Bad Request" } } } }, "/api/v1/public/general/exchanges": { "get": { "tags": [ "General" ], "description": "Query for all exchanges available in the database.", "parameters": [], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/general/screener": { "get": { "tags": [ "General" ], "description": "Filter listed instruments by fundamentals, exchange, sector, and other criteria. Supports sorting and pagination. Coverage: 70+ exchanges, 100,000+ tickers. Costs 10 request units per call. The filters query parameter must be valid JSON with double-quoted strings and URL-encoded as a whole, e.g. %5B%5B%22exchange%22%2C%22%3D%22%2C%22XETRA%22%5D%5D for [[\"exchange\",\"=\",\"XETRA\"]].", "parameters": [ { "name": "filters", "in": "query", "description": "Valid JSON array of filter tuples with double-quoted strings: [[field, operation, value], ...]. String fields support = and match; numeric fields support =, >, <, >=, <=.", "example": "[[\"exchange\",\"=\",\"XETRA\"]]", "schema": { "type": "string" } }, { "name": "signals", "in": "query", "description": "Comma-separated pre-calculated signals. Options: 50d_new_lo, 50d_new_hi, 200d_new_lo, 200d_new_hi, bookvalue_neg, bookvalue_pos, wallstreet_lo, wallstreet_hi.", "example": "200d_new_hi,wallstreet_hi", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Sort by a numeric field, ascending or descending.", "example": "market_capitalization.desc", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of results to return. Default 50, min 1, max 100.", "example": 10, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "description": "Pagination offset. Default 0, max 999.", "example": 0, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP" }, "exchange": { "type": "string", "example": "XETRA" }, "name": { "type": "string", "example": "SAP SE" }, "sector": { "type": "string", "example": "Technology" }, "industry": { "type": "string", "example": "Software" }, "market_capitalization": { "type": "number", "example": 163761831936 }, "earnings_share": { "type": "number", "example": 6.24 }, "dividend_yield": { "type": "number", "example": 0.0179 } } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP" }, "exchange": { "type": "string", "example": "XETRA" }, "name": { "type": "string", "example": "SAP SE" }, "sector": { "type": "string", "example": "Technology" }, "industry": { "type": "string", "example": "Software" }, "market_capitalization": { "type": "number", "example": 163761831936 }, "earnings_share": { "type": "number", "example": 6.24 }, "dividend_yield": { "type": "number", "example": 0.0179 } } } } }, "xml": { "name": "main" } } } } }, "400": { "description": "Invalid filters JSON", "content": { "application/json": { "schema": { "type": "object", "properties": { "errors": { "type": "object", "properties": { "filters": { "type": "array", "example": [ "filters must be a valid JSON array with double-quoted strings, e.g. [[\"exchange\",\"=\",\"XETRA\"]]" ], "items": { "type": "string" } } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "errors": { "type": "object", "properties": { "filters": { "type": "array", "example": [ "filters must be a valid JSON array with double-quoted strings, e.g. [[\"exchange\",\"=\",\"XETRA\"]]" ], "items": { "type": "string" } } } } }, "xml": { "name": "main" } } } } } } } }, "/api/v1/public/general/tradingperiod/{symbolExchange}": { "get": { "tags": [ "General" ], "description": "Get the first and last date the requested stock was tradable on the exchange. Returns two datestrings in an object.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Not Found" } } } }, "/api/v1/public/general/dailyrequestsleft": { "get": { "tags": [ "General" ], "description": "Get the amount of requests you have left this day.", "parameters": [ { "name": "apitoken", "in": "query", "type": "string" } ], "responses": { "200": { "description": "OK" }, "404": { "description": "Not Found" } } } }, "/api/v1/public/historicalquotes/marketwide-lastday-quote/{exchange}": { "get": { "tags": [ "Price Data", "Market Data" ], "summary": "Last trading day quote for an entire exchange", "description": "One OHLCV bar per listed instrument on an exchange for a trading day—useful for screening an entire market in one call across 70+ exchanges. Omit date for the latest session. Costs 1 request unit per call.", "parameters": [ { "name": "exchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Exchange code", "example": "XETRA" }, { "name": "date", "in": "query", "description": "Trading date (YYYY-MM-DD). Default: last trading day.", "example": "2026-06-10", "schema": { "type": "string" } }, { "name": "symbols", "in": "query", "description": "Optional. Comma-separated symbols to limit results.", "example": "SAP,RWE,ALV", "schema": { "type": "string" } }, { "name": "filter", "in": "query", "enum": [ "extended" ], "description": "Extended fields (name, EMAs, avg volumes). Past 30 days only.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 154.1 }, "high": { "type": "number", "example": 154.32 }, "low": { "type": "number", "example": 146.14 }, "close": { "type": "number", "example": 149.7 }, "adjusted_close": { "type": "number", "example": 149.7 }, "volume": { "type": "number", "example": 3601948 }, "Code": { "type": "string", "example": "SAP" }, "Exchange": { "type": "string", "example": "XETRA" } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 154.1 }, "high": { "type": "number", "example": 154.32 }, "low": { "type": "number", "example": 146.14 }, "close": { "type": "number", "example": 149.7 }, "adjusted_close": { "type": "number", "example": 149.7 }, "volume": { "type": "number", "example": 3601948 }, "Code": { "type": "string", "example": "SAP" }, "Exchange": { "type": "string", "example": "XETRA" } } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Server Error" } } } }, "/api/v1/public/historicalquotes/{symbolExchange}": { "get": { "tags": [ "Price Data", "Stocks", "Cryptocurrencies", "Currencies", "Bonds", "Fonds", "ETFs", "Commodities" ], "description": "Historical end-of-day OHLCV bars as a JSON array—up to 35 years of history across 70+ exchanges, 100,000+ tickers, 15,000+ ETFs, and 1,000+ forex pairs. Forex and crypto are realtime; other instruments are typically 15 minutes delayed. Costs 1 request unit per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "filter", "description": "Set this to e.g. close to get only ONE (e.g. close) for each day. Date is always returned. Keys are renamed to time,value", "in": "query", "schema": { "type": "string" } }, { "name": "byname", "in": "query", "description": "Set this to true and pass a Companyname in symbolExchange.", "schema": { "type": "string" } }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 154.1 }, "high": { "type": "number", "example": 154.32 }, "low": { "type": "number", "example": 146.14 }, "close": { "type": "number", "example": 149.7 }, "adjusted_close": { "type": "number", "example": 149.7 }, "volume": { "type": "number", "example": 3601948 } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 154.1 }, "high": { "type": "number", "example": 154.32 }, "low": { "type": "number", "example": 146.14 }, "close": { "type": "number", "example": 149.7 }, "adjusted_close": { "type": "number", "example": 149.7 }, "volume": { "type": "number", "example": 3601948 } } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" } } } }, "/api/v1/public/historicalquotes/marketcap/{symbolExchange}": { "get": { "tags": [ "Price Data", "Stocks", "Fundamentals" ], "description": "Historical market cap or valuation multiples for a symbol. Set valuation=pe|pb|ps|pc|liab for a single ratio series, or valuation=all for all five (pe, pc, pb, ps, liab)—each as daily open/high/low/close of the multiple. Up to 35 years of history. Costs 2 request units per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "byname", "in": "query", "description": "Set this to true and pass a Companyname in symbolExchange.", "schema": { "type": "string" } }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "valuation", "description": "Optional. pe, pb, ps, pc, or liab for one ratio; all returns an object with all five keys. Omit for market-cap history.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK. With valuation=all, returns pe, pc, pb, ps, and liab—each key is an array of daily OHLC bars for that multiple. Example shows pe for SAP.XETRA; other keys share the same shape.", "content": { "application/json": { "schema": { "type": "object", "properties": { "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "1997-01-06" }, "open": { "type": "number", "example": 19.876 }, "high": { "type": "number", "example": 20.159 }, "low": { "type": "number", "example": 19.782 }, "close": { "type": "number", "example": 19.858 } } } }, "pc": { "type": "array", "example": [], "items": {} }, "pb": { "type": "array", "example": [], "items": {} }, "ps": { "type": "array", "example": [], "items": {} }, "liab": { "type": "array", "example": [], "items": {} } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "1997-01-06" }, "open": { "type": "number", "example": 19.876 }, "high": { "type": "number", "example": 20.159 }, "low": { "type": "number", "example": 19.782 }, "close": { "type": "number", "example": 19.858 } } } }, "pc": { "type": "array", "example": [], "items": {} }, "pb": { "type": "array", "example": [], "items": {} }, "ps": { "type": "array", "example": [], "items": {} }, "liab": { "type": "array", "example": [], "items": {} } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" } } } }, "/api/v1/public/historicalquotes/marketcap/aggregation/{type}": { "get": { "tags": [ "Price Data", "Market", "Fundamentals" ], "description": "Aggregated valuation multiples across sectors, countries and market cap.", "parameters": [ { "name": "type", "in": "path", "required": true, "schema": { "type": "string" }, "description": "History of common multiples, options are pe, pb, ps, pc, liab for ratios of price in regard to earnings, bookvalue, sales, cashflow and liabilities." }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "country", "description": "Limits aggregation to companies of that country or area (EU, NA, ASIA, OTHER)", "in": "query", "schema": { "type": "string" } }, { "name": "sector", "description": "Limits aggregation to companies of that sector or industry", "in": "query", "schema": { "type": "string" } }, { "name": "minCap", "description": "Limits aggregation to companies of marketcap between greater than minCap", "in": "query", "schema": { "type": "string" } }, { "name": "maxCap", "description": "Limits aggregation to companies of marketcap between smaller than maxCap", "in": "query", "schema": { "type": "string" } }, { "name": "symbolExchange", "in": "path", "description": "Symbol and Exchange", "required": true, "example": "SAP.XETRA", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Bad Request" } } } }, "/api/v1/public/fundamentals/{symbolExchange}": { "get": { "tags": [ "Fundamentals", "Stocks", "ETFs", "Fonds" ], "description": "Up to 20 years of balance sheets, income statements, and cash flows—plus analyst estimates and earnings history. Coverage: 70+ exchanges, 100,000+ tickers, 15,000+ ETFs. Costs 10 request units per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "lang", "description": "Language setting, default is english. Input 'german' for translated version.", "in": "query", "schema": { "type": "string" } }, { "name": "fmt", "description": "Output format, default is JSON. Options: XML", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "General": { "type": "object", "properties": { "Code": { "type": "string", "example": "SAP" }, "Type": { "type": "string", "example": "Common Stock" }, "Name": { "type": "string", "example": "SAP SE" }, "Exchange": { "type": "string", "example": "XETRA" }, "CurrencyCode": { "type": "string", "example": "EUR" }, "CurrencyName": { "type": "string", "example": "Euro" }, "CurrencySymbol": { "type": "string", "example": "€" }, "CountryName": { "type": "string", "example": "Deutschland" }, "CountryISO": { "type": "string", "example": "DE" }, "ISIN": { "type": "string", "example": "DE0007164600" }, "LEI": { "type": "string", "example": "529900D6BF99LW9R2E68" }, "PrimaryTicker": { "type": "string", "example": "SAP.F" }, "FiscalYearEnd": { "type": "string", "example": "Dezember" }, "IPODate": { "type": "string", "example": "1998-04-09" }, "Sector": { "type": "string", "example": "Technologie" }, "Industry": { "type": "string", "example": "Software" }, "GicSector": { "type": "string", "example": "Information Technology" }, "GicIndustry": { "type": "string", "example": "Software" }, "GicSubIndustry": { "type": "string", "example": "Application Software" }, "Description": { "type": "string", "example": "SAP SE provides enterprise application and business solutions worldwide—ERP, cloud, analytics, and industry-specific software." }, "FullTimeEmployees": { "type": "number", "example": 111038 }, "Officers": { "type": "array", "items": { "type": "object", "properties": { "Name": { "type": "string", "example": "Mr. Dominik Asam" }, "Title": { "type": "string", "example": "CFO & Member of Executive Board" }, "YearBorn": { "type": "string", "example": "1969" } } } } } }, "Highlights": { "type": "object", "properties": { "MarketCapitalization": { "type": "number", "example": 163761831936 }, "PERatio": { "type": "number", "example": 22.4776 }, "PEGRatio": { "type": "number", "example": 1.4159 }, "BookValue": { "type": "number", "example": 38.187 }, "DividendShare": { "type": "number", "example": 2.5 }, "DividendYield": { "type": "number", "example": 0.0179 }, "EarningsShare": { "type": "number", "example": 6.24 }, "EPSEstimateCurrentYear": { "type": "number", "example": 7.2834 }, "EPSEstimateNextYear": { "type": "number", "example": 8.5652 }, "MostRecentQuarter": { "type": "string", "example": "2026-03-31" }, "ProfitMargin": { "type": "number", "example": 0.1958 }, "OperatingMarginTTM": { "type": "number", "example": 0.3003 }, "ReturnOnEquityTTM": { "type": "number", "example": 0.1635 }, "RevenueTTM": { "type": "number", "example": 37341999104 }, "RevenuePerShareTTM": { "type": "number", "example": 32.053 }, "QuarterlyRevenueGrowthYOY": { "type": "number", "example": 0.06 }, "GrossProfitTTM": { "type": "number", "example": 27527999488 }, "DilutedEpsTTM": { "type": "number", "example": 6.24 }, "QuarterlyEarningsGrowthYOY": { "type": "number", "example": 0.093 } } }, "Valuation": { "type": "object", "properties": { "TrailingPE": { "type": "number", "example": 22.4776 }, "ForwardPE": { "type": "number", "example": 19.1939 }, "PriceSalesTTM": { "type": "number", "example": 4.3855 }, "PriceBookMRQ": { "type": "number", "example": 3.6505 }, "EnterpriseValue": { "type": "number", "example": 161158510815 }, "EnterpriseValueRevenue": { "type": "number", "example": 4.327 }, "EnterpriseValueEbitda": { "type": "number", "example": 13.1162 } } }, "Technicals": { "type": "object", "properties": { "Beta": { "type": "number", "example": 0.727 }, "52WeekHigh": { "type": "number", "example": 264.8548 }, "52WeekLow": { "type": "number", "example": 135.2446 }, "50DayMA": { "type": "number", "example": 149.552 }, "200DayMA": { "type": "number", "example": 187.7605 } } }, "SplitsDividends": { "type": "object", "properties": { "ForwardAnnualDividendRate": { "type": "number", "example": 2.5 }, "ForwardAnnualDividendYield": { "type": "number", "example": 0.0179 }, "PayoutRatio": { "type": "number", "example": 0.384 }, "ExDividendDate": { "type": "string", "example": "2026-05-06" }, "LastSplitFactor": { "type": "string", "example": "3:1" }, "LastSplitDate": { "type": "string", "example": "2000-06-26" }, "NumberDividendsByYear": { "type": "array", "items": { "type": "object", "properties": { "Year": { "type": "string", "example": "2026" }, "Count": { "type": "number", "example": 1 } } } } } }, "outstandingShares": { "type": "object", "properties": { "annual": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2024" }, "dateFormatted": { "type": "string", "example": "2024-12-31" }, "sharesMln": { "type": "number", "example": 1176 }, "shares": { "type": "number", "example": 1176000000 } } } }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-Q4" }, "dateFormatted": { "type": "string", "example": "2025-12-31" }, "sharesMln": { "type": "number", "example": 1172 }, "shares": { "type": "number", "example": 1172000000 } } } } } }, "Earnings": { "type": "object", "properties": { "History": { "type": "array", "items": { "type": "object", "properties": { "reportDate": { "type": "string", "example": "2025-07-22" }, "date": { "type": "string", "example": "2025-06-30" }, "beforeAfterMarket": { "type": "string", "example": "AfterMarket" }, "currency": { "type": "string", "example": "EUR" }, "epsActual": { "type": "number", "example": 1.45 }, "epsEstimate": { "type": "number", "example": 1.38 }, "epsDifference": { "type": "number", "example": 0.07 }, "surprisePercent": { "type": "number", "example": 5.0725 } } } }, "Trend": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2027-12-31" }, "period": { "type": "string", "example": "+1y" }, "earningsEstimateAvg": { "type": "number", "example": 8.5652 }, "revenueEstimateAvg": { "type": "number", "example": 45241104100 }, "earningsEstimateNumberOfAnalysts": { "type": "number", "example": 15 } } } } } }, "Financials": { "type": "object", "properties": { "Balance_Sheet": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalAssets": { "type": "number", "example": 70362000000 }, "totalLiab": { "type": "number", "example": 25125000000 }, "totalStockholderEquity": { "type": "number", "example": 44752000000 }, "cash": { "type": "number", "example": 8220000000 }, "totalCurrentAssets": { "type": "number", "example": 20256000000 }, "totalCurrentLiabilities": { "type": "number", "example": 17250000000 }, "goodWill": { "type": "number", "example": 29014000000 }, "retainedEarnings": { "type": "number", "example": 47511000000 }, "netWorkingCapital": { "type": "number", "example": 2840000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalAssets": { "type": "number", "example": 68331000000 }, "totalLiab": { "type": "number", "example": 24925000000 }, "totalStockholderEquity": { "type": "number", "example": 43157000000 }, "cash": { "type": "number", "example": 8124000000 }, "totalCurrentAssets": { "type": "number", "example": 20571000000 }, "totalCurrentLiabilities": { "type": "number", "example": 14641000000 }, "goodWill": { "type": "number", "example": 29081000000 }, "retainedEarnings": { "type": "number", "example": 42457000000 }, "netWorkingCapital": { "type": "number", "example": 5929000000 } } } } } }, "Cash_Flow": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "netIncome": { "type": "number", "example": 1846000000 }, "totalCashFromOperatingActivities": { "type": "number", "example": 1277000000 }, "capitalExpenditures": { "type": "number", "example": 180000000 }, "freeCashFlow": { "type": "number", "example": 1097000000 }, "dividendsPaid": { "type": "number", "example": 2743000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "netIncome": { "type": "number", "example": 5964000000 }, "totalCashFromOperatingActivities": { "type": "number", "example": 6332000000 }, "capitalExpenditures": { "type": "number", "example": 785000000 }, "freeCashFlow": { "type": "number", "example": 5547000000 }, "dividendsPaid": { "type": "number", "example": 2395000000 } } } } } }, "Income_Statement": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalRevenue": { "type": "number", "example": 9684000000 }, "grossProfit": { "type": "number", "example": 7070000000 }, "operatingIncome": { "type": "number", "example": 2676000000 }, "ebit": { "type": "number", "example": 2676000000 }, "ebitda": { "type": "number", "example": 2990875196 }, "netIncome": { "type": "number", "example": 1846000000 }, "researchDevelopment": { "type": "number", "example": 1697000000 }, "incomeBeforeTax": { "type": "number", "example": 2767000000 }, "incomeTaxExpense": { "type": "number", "example": 871000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalRevenue": { "type": "number", "example": 31207000000 }, "grossProfit": { "type": "number", "example": 22603000000 }, "operatingIncome": { "type": "number", "example": 6584000000 }, "ebit": { "type": "number", "example": 6584000000 }, "ebitda": { "type": "number", "example": 7957000000 }, "netIncome": { "type": "number", "example": 3598000000 }, "researchDevelopment": { "type": "number", "example": 6317000000 }, "incomeBeforeTax": { "type": "number", "example": 5341000000 }, "incomeTaxExpense": { "type": "number", "example": 1741000000 } } } } } } } }, "SharesStats": { "type": "object", "properties": { "SharesOutstanding": { "type": "number", "example": 1167559048 }, "SharesFloat": { "type": "number", "example": 1038838120 }, "PercentInsiders": { "type": "number", "example": 11.313 }, "PercentInstitutions": { "type": "number", "example": 39.707 } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "General": { "type": "object", "properties": { "Code": { "type": "string", "example": "SAP" }, "Type": { "type": "string", "example": "Common Stock" }, "Name": { "type": "string", "example": "SAP SE" }, "Exchange": { "type": "string", "example": "XETRA" }, "CurrencyCode": { "type": "string", "example": "EUR" }, "CurrencyName": { "type": "string", "example": "Euro" }, "CurrencySymbol": { "type": "string", "example": "€" }, "CountryName": { "type": "string", "example": "Deutschland" }, "CountryISO": { "type": "string", "example": "DE" }, "ISIN": { "type": "string", "example": "DE0007164600" }, "LEI": { "type": "string", "example": "529900D6BF99LW9R2E68" }, "PrimaryTicker": { "type": "string", "example": "SAP.F" }, "FiscalYearEnd": { "type": "string", "example": "Dezember" }, "IPODate": { "type": "string", "example": "1998-04-09" }, "Sector": { "type": "string", "example": "Technologie" }, "Industry": { "type": "string", "example": "Software" }, "GicSector": { "type": "string", "example": "Information Technology" }, "GicIndustry": { "type": "string", "example": "Software" }, "GicSubIndustry": { "type": "string", "example": "Application Software" }, "Description": { "type": "string", "example": "SAP SE provides enterprise application and business solutions worldwide—ERP, cloud, analytics, and industry-specific software." }, "FullTimeEmployees": { "type": "number", "example": 111038 }, "Officers": { "type": "array", "items": { "type": "object", "properties": { "Name": { "type": "string", "example": "Mr. Dominik Asam" }, "Title": { "type": "string", "example": "CFO & Member of Executive Board" }, "YearBorn": { "type": "string", "example": "1969" } } } } } }, "Highlights": { "type": "object", "properties": { "MarketCapitalization": { "type": "number", "example": 163761831936 }, "PERatio": { "type": "number", "example": 22.4776 }, "PEGRatio": { "type": "number", "example": 1.4159 }, "BookValue": { "type": "number", "example": 38.187 }, "DividendShare": { "type": "number", "example": 2.5 }, "DividendYield": { "type": "number", "example": 0.0179 }, "EarningsShare": { "type": "number", "example": 6.24 }, "EPSEstimateCurrentYear": { "type": "number", "example": 7.2834 }, "EPSEstimateNextYear": { "type": "number", "example": 8.5652 }, "MostRecentQuarter": { "type": "string", "example": "2026-03-31" }, "ProfitMargin": { "type": "number", "example": 0.1958 }, "OperatingMarginTTM": { "type": "number", "example": 0.3003 }, "ReturnOnEquityTTM": { "type": "number", "example": 0.1635 }, "RevenueTTM": { "type": "number", "example": 37341999104 }, "RevenuePerShareTTM": { "type": "number", "example": 32.053 }, "QuarterlyRevenueGrowthYOY": { "type": "number", "example": 0.06 }, "GrossProfitTTM": { "type": "number", "example": 27527999488 }, "DilutedEpsTTM": { "type": "number", "example": 6.24 }, "QuarterlyEarningsGrowthYOY": { "type": "number", "example": 0.093 } } }, "Valuation": { "type": "object", "properties": { "TrailingPE": { "type": "number", "example": 22.4776 }, "ForwardPE": { "type": "number", "example": 19.1939 }, "PriceSalesTTM": { "type": "number", "example": 4.3855 }, "PriceBookMRQ": { "type": "number", "example": 3.6505 }, "EnterpriseValue": { "type": "number", "example": 161158510815 }, "EnterpriseValueRevenue": { "type": "number", "example": 4.327 }, "EnterpriseValueEbitda": { "type": "number", "example": 13.1162 } } }, "Technicals": { "type": "object", "properties": { "Beta": { "type": "number", "example": 0.727 }, "52WeekHigh": { "type": "number", "example": 264.8548 }, "52WeekLow": { "type": "number", "example": 135.2446 }, "50DayMA": { "type": "number", "example": 149.552 }, "200DayMA": { "type": "number", "example": 187.7605 } } }, "SplitsDividends": { "type": "object", "properties": { "ForwardAnnualDividendRate": { "type": "number", "example": 2.5 }, "ForwardAnnualDividendYield": { "type": "number", "example": 0.0179 }, "PayoutRatio": { "type": "number", "example": 0.384 }, "ExDividendDate": { "type": "string", "example": "2026-05-06" }, "LastSplitFactor": { "type": "string", "example": "3:1" }, "LastSplitDate": { "type": "string", "example": "2000-06-26" }, "NumberDividendsByYear": { "type": "array", "items": { "type": "object", "properties": { "Year": { "type": "string", "example": "2026" }, "Count": { "type": "number", "example": 1 } } } } } }, "outstandingShares": { "type": "object", "properties": { "annual": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2024" }, "dateFormatted": { "type": "string", "example": "2024-12-31" }, "sharesMln": { "type": "number", "example": 1176 }, "shares": { "type": "number", "example": 1176000000 } } } }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-Q4" }, "dateFormatted": { "type": "string", "example": "2025-12-31" }, "sharesMln": { "type": "number", "example": 1172 }, "shares": { "type": "number", "example": 1172000000 } } } } } }, "Earnings": { "type": "object", "properties": { "History": { "type": "array", "items": { "type": "object", "properties": { "reportDate": { "type": "string", "example": "2025-07-22" }, "date": { "type": "string", "example": "2025-06-30" }, "beforeAfterMarket": { "type": "string", "example": "AfterMarket" }, "currency": { "type": "string", "example": "EUR" }, "epsActual": { "type": "number", "example": 1.45 }, "epsEstimate": { "type": "number", "example": 1.38 }, "epsDifference": { "type": "number", "example": 0.07 }, "surprisePercent": { "type": "number", "example": 5.0725 } } } }, "Trend": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2027-12-31" }, "period": { "type": "string", "example": "+1y" }, "earningsEstimateAvg": { "type": "number", "example": 8.5652 }, "revenueEstimateAvg": { "type": "number", "example": 45241104100 }, "earningsEstimateNumberOfAnalysts": { "type": "number", "example": 15 } } } } } }, "Financials": { "type": "object", "properties": { "Balance_Sheet": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalAssets": { "type": "number", "example": 70362000000 }, "totalLiab": { "type": "number", "example": 25125000000 }, "totalStockholderEquity": { "type": "number", "example": 44752000000 }, "cash": { "type": "number", "example": 8220000000 }, "totalCurrentAssets": { "type": "number", "example": 20256000000 }, "totalCurrentLiabilities": { "type": "number", "example": 17250000000 }, "goodWill": { "type": "number", "example": 29014000000 }, "retainedEarnings": { "type": "number", "example": 47511000000 }, "netWorkingCapital": { "type": "number", "example": 2840000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalAssets": { "type": "number", "example": 68331000000 }, "totalLiab": { "type": "number", "example": 24925000000 }, "totalStockholderEquity": { "type": "number", "example": 43157000000 }, "cash": { "type": "number", "example": 8124000000 }, "totalCurrentAssets": { "type": "number", "example": 20571000000 }, "totalCurrentLiabilities": { "type": "number", "example": 14641000000 }, "goodWill": { "type": "number", "example": 29081000000 }, "retainedEarnings": { "type": "number", "example": 42457000000 }, "netWorkingCapital": { "type": "number", "example": 5929000000 } } } } } }, "Cash_Flow": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "netIncome": { "type": "number", "example": 1846000000 }, "totalCashFromOperatingActivities": { "type": "number", "example": 1277000000 }, "capitalExpenditures": { "type": "number", "example": 180000000 }, "freeCashFlow": { "type": "number", "example": 1097000000 }, "dividendsPaid": { "type": "number", "example": 2743000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "netIncome": { "type": "number", "example": 5964000000 }, "totalCashFromOperatingActivities": { "type": "number", "example": 6332000000 }, "capitalExpenditures": { "type": "number", "example": 785000000 }, "freeCashFlow": { "type": "number", "example": 5547000000 }, "dividendsPaid": { "type": "number", "example": 2395000000 } } } } } }, "Income_Statement": { "type": "object", "properties": { "currency_symbol": { "type": "string", "example": "EUR" }, "quarterly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-12-31" }, "filing_date": { "type": "string", "example": "2025-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalRevenue": { "type": "number", "example": 9684000000 }, "grossProfit": { "type": "number", "example": 7070000000 }, "operatingIncome": { "type": "number", "example": 2676000000 }, "ebit": { "type": "number", "example": 2676000000 }, "ebitda": { "type": "number", "example": 2990875196 }, "netIncome": { "type": "number", "example": 1846000000 }, "researchDevelopment": { "type": "number", "example": 1697000000 }, "incomeBeforeTax": { "type": "number", "example": 2767000000 }, "incomeTaxExpense": { "type": "number", "example": 871000000 } } } }, "yearly": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2023-12-31" }, "filing_date": { "type": "string", "example": "2023-12-31" }, "currency_symbol": { "type": "string", "example": "EUR" }, "totalRevenue": { "type": "number", "example": 31207000000 }, "grossProfit": { "type": "number", "example": 22603000000 }, "operatingIncome": { "type": "number", "example": 6584000000 }, "ebit": { "type": "number", "example": 6584000000 }, "ebitda": { "type": "number", "example": 7957000000 }, "netIncome": { "type": "number", "example": 3598000000 }, "researchDevelopment": { "type": "number", "example": 6317000000 }, "incomeBeforeTax": { "type": "number", "example": 5341000000 }, "incomeTaxExpense": { "type": "number", "example": 1741000000 } } } } } } } }, "SharesStats": { "type": "object", "properties": { "SharesOutstanding": { "type": "number", "example": 1167559048 }, "SharesFloat": { "type": "number", "example": 1038838120 }, "PercentInsiders": { "type": "number", "example": 11.313 }, "PercentInstitutions": { "type": "number", "example": 39.707 } } } }, "xml": { "name": "main" } } } } }, "404": { "description": "Not Found" } } } }, "/api/v1/public/fundamentals/forecast/{symbolExchange}": { "get": { "tags": [ "Fundamentals", "Stocks" ], "description": "Generates or retrieves financial forecasts for the specified symbol and exchange. We look at patterns in quarterly and yearly projections—revenue, net income, EPS, and the like—to see where the numbers are heading. It’s a calculation of what has already been set in motion. Costs 10 request units per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "quarterly": { "type": "object", "properties": { "netIncome": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 1656463455.99 } } } }, "revenue": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 9569003434.62 } } } }, "ebit": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 2712878610.25 } } } }, "ebitda": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 3282783604.75 } } } }, "freeCashFlow": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 1730634134.13 } } } }, "totalCashFromOperatingActivities": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 2029384388.87 } } } }, "totalStockholderEquity": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 46013467290.54 } } } }, "ratios": { "type": "object", "properties": { "eps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 6.31 } } } }, "bvps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 39.46 } } } }, "revenuePerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 32.85 } } } }, "cashflowPerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 8.84 } } } }, "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 22.82 } } } }, "ps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 4.38 } } } }, "pb": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 3.65 } } } }, "pc": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 16.27 } } } } } } } }, "yearly": { "type": "object", "properties": { "netIncome": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 8476993600 } } } }, "revenue": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 40145059564 } } } }, "ebit": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 13050755483.43 } } } }, "ebitda": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 14663577152.52 } } } }, "freeCashFlow": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 9219149229 } } } }, "totalCashFromOperatingActivities": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 10810602400 } } } }, "totalStockholderEquity": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 49417562684 } } } }, "ratios": { "type": "object", "properties": { "eps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 7.26 } } } }, "bvps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 42.31 } } } }, "revenuePerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 34.37 } } } }, "cashflowPerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 9.26 } } } }, "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 19.83 } } } }, "ps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 4.19 } } } }, "pb": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 3.4 } } } }, "pc": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 15.55 } } } } } } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "quarterly": { "type": "object", "properties": { "netIncome": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 1656463455.99 } } } }, "revenue": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 9569003434.62 } } } }, "ebit": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 2712878610.25 } } } }, "ebitda": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 3282783604.75 } } } }, "freeCashFlow": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 1730634134.13 } } } }, "totalCashFromOperatingActivities": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 2029384388.87 } } } }, "totalStockholderEquity": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 46013467290.54 } } } }, "ratios": { "type": "object", "properties": { "eps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 6.31 } } } }, "bvps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 39.46 } } } }, "revenuePerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 32.85 } } } }, "cashflowPerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 8.84 } } } }, "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 22.82 } } } }, "ps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 4.38 } } } }, "pb": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 3.65 } } } }, "pc": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-30" }, "value": { "type": "number", "example": 16.27 } } } } } } } }, "yearly": { "type": "object", "properties": { "netIncome": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 8476993600 } } } }, "revenue": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 40145059564 } } } }, "ebit": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 13050755483.43 } } } }, "ebitda": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 14663577152.52 } } } }, "freeCashFlow": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 9219149229 } } } }, "totalCashFromOperatingActivities": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 10810602400 } } } }, "totalStockholderEquity": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 49417562684 } } } }, "ratios": { "type": "object", "properties": { "eps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 7.26 } } } }, "bvps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 42.31 } } } }, "revenuePerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 34.37 } } } }, "cashflowPerShare": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 9.26 } } } }, "pe": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 19.83 } } } }, "ps": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 4.19 } } } }, "pb": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 3.4 } } } }, "pc": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-12-31" }, "value": { "type": "number", "example": 15.55 } } } } } } } } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" }, "404": { "description": "Not Found" } } } }, "/api/v1/public/live/{symbolExchange}": { "get": { "tags": [ "Price Data", "Stocks", "Cryptocurrencies", "Currencies", "Bonds", "Fonds", "ETFs", "Commodities" ], "description": "Latest quote for a symbol as a JSON object. Coverage spans 70+ exchanges, 100,000+ tickers, 15,000+ ETFs, and 1,000+ forex pairs. Forex and crypto are realtime; equities and most other instruments are typically 15 minutes delayed. Costs 1 request unit per symbol (multi counts each ticker).", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "multi", "in": "query", "description": "Optional: Comma-separated list of additional SYMBOL.EXCHANGE tickers. Response is an array when provided.", "required": false, "example": "SAP.XETRA,EURUSD.FOREX", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP.XETRA" }, "timestamp": { "type": "number", "example": 1781176560 }, "gmtoffset": { "type": "number", "example": 0 }, "open": { "type": "number", "example": 148.54 }, "high": { "type": "number", "example": 148.54 }, "low": { "type": "number", "example": 142 }, "close": { "type": "number", "example": 143.66 }, "volume": { "type": "number", "example": 1552016 }, "previousClose": { "type": "number", "example": 149.7 }, "change": { "type": "number", "example": -6.04 }, "change_p": { "type": "number", "example": -4.0347 } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP.XETRA" }, "timestamp": { "type": "number", "example": 1781176560 }, "gmtoffset": { "type": "number", "example": 0 }, "open": { "type": "number", "example": 148.54 }, "high": { "type": "number", "example": 148.54 }, "low": { "type": "number", "example": 142 }, "close": { "type": "number", "example": 143.66 }, "volume": { "type": "number", "example": 1552016 }, "previousClose": { "type": "number", "example": 149.7 }, "change": { "type": "number", "example": -6.04 }, "change_p": { "type": "number", "example": -4.0347 } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" }, "429": { "description": "Too Many Requests" }, "502": { "description": "Bad Gateway" } } } }, "/api/v1/public/dividends/{symbolExchange}": { "get": { "tags": [ "Dividends", "Calendar", "Stocks" ], "description": "Dividend history for a symbol—declaration, record, and payment dates with adjusted and unadjusted amounts. Costs 2 request units per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "apitoken", "in": "query", "type": "string" }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date.", "in": "query", "schema": { "type": "string" } }, { "name": "calculations", "description": "Format: Boolean. If true, returns price at Ex-Div date as well as dividend payout ratio.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-05-06" }, "declarationDate": { "type": "string", "example": "2026-02-19" }, "paymentDate": { "type": "string", "example": "2026-05-08" }, "period": { "type": "string", "example": "Interim" }, "value": { "type": "number", "example": 2.5 }, "unadjustedValue": { "type": "number", "example": 2.5 }, "currency": { "type": "string", "example": "EUR" } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-05-06" }, "declarationDate": { "type": "string", "example": "2026-02-19" }, "paymentDate": { "type": "string", "example": "2026-05-08" }, "period": { "type": "string", "example": "Interim" }, "value": { "type": "number", "example": 2.5 }, "unadjustedValue": { "type": "number", "example": 2.5 }, "currency": { "type": "string", "example": "EUR" } } }, "xml": { "name": "main" } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Too Many Requests" } } } }, "/api/v1/public/dividends/history/{symbolExchange}": { "get": { "tags": [ "Dividends", "Calendar", "Stocks" ], "description": "Historical dividend yield series derived from payouts and price—one entry per trading day. Costs 2 request units per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "apitoken", "in": "query", "type": "string" }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date.", "in": "query", "schema": { "type": "string" } }, { "name": "calculations", "description": "Format: Boolean. If true, returns price at Ex-Div date as well as dividend payout ratio.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 1.57 }, "high": { "type": "number", "example": 1.58 }, "low": { "type": "number", "example": 1.54 }, "close": { "type": "number", "example": 1.56 } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2026-06-10" }, "open": { "type": "number", "example": 1.57 }, "high": { "type": "number", "example": 1.58 }, "low": { "type": "number", "example": 1.54 }, "close": { "type": "number", "example": 1.56 } } }, "xml": { "name": "main" } } } } }, "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/public/splits/{symbolExchange}": { "get": { "tags": [ "Splits", "Calendar", "Stocks" ], "description": "Stock split history for a symbol—effective dates and split ratios. Costs 1 request unit per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2006-12-21" }, "split": { "type": "string", "example": "4.000000/1.000000" } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2006-12-21" }, "split": { "type": "string", "example": "4.000000/1.000000" } } }, "xml": { "name": "main" } } } } }, "429": { "description": "Too Many Requests" } } } }, "/api/v1/public/intraday/{symbolExchange}": { "get": { "tags": [ "Price Data", "Stocks", "Cryptocurrencies", "Currencies", "Bonds", "Fonds", "ETFs", "Commodities" ], "description": "Historical intraday OHLCV bars as a JSON array (1m on US NYSE/NASDAQ, otherwise 5m or 1h). Same global coverage as our EOD feed—70+ exchanges, 100,000+ tickers, 15,000+ ETFs, 1,000+ forex pairs. Costs 1 request unit per call.", "parameters": [ { "name": "symbolExchange", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Symbol and Exchange", "example": "SAP.XETRA" }, { "name": "interval", "in": "query", "description": "'5m' for 5 minutes, '1h' for 1 hour, and '1m' for 1 minute intervals. 1 minute is only available for US exchanges NYSE and NASDAQ.", "schema": { "type": "string" } }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "timestamp": { "type": "number", "example": 1781105400 }, "gmtoffset": { "type": "number", "example": 0 }, "datetime": { "type": "string", "example": "2026-06-10 15:30:00" }, "open": { "type": "number", "example": 149.699996 }, "high": { "type": "number", "example": 149.699996 }, "low": { "type": "number", "example": 149.699996 }, "close": { "type": "number", "example": 149.699996 } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "timestamp": { "type": "number", "example": 1781105400 }, "gmtoffset": { "type": "number", "example": 0 }, "datetime": { "type": "string", "example": "2026-06-10 15:30:00" }, "open": { "type": "number", "example": 149.699996 }, "high": { "type": "number", "example": 149.699996 }, "low": { "type": "number", "example": 149.699996 }, "close": { "type": "number", "example": 149.699996 } } }, "xml": { "name": "main" } } } } }, "429": { "description": "Too Many Requests" } } } }, "/api/v1/public/events/ipos": { "get": { "tags": [ "IPOs", "Calendar", "Stocks" ], "description": "Upcoming and recent IPOs across covered exchanges—pricing range, shares offered, and deal status. Costs 2 request units per call.", "parameters": [ { "name": "apitoken", "in": "query", "type": "string" }, { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "symbols", "description": "List of tickers in format SYMBOL.EXCHANGE, comma-separated. Example: SAP.XETRA", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "IPOs" }, "description": { "type": "string", "example": "Historical and upcoming IPOs" }, "from": { "type": "string", "example": "2026-06-11" }, "to": { "type": "string", "example": "2026-06-18" }, "ipos": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "FCBM.US" }, "name": { "type": "string", "example": "First Carolina Financial Services, Inc." }, "exchange": { "type": "string", "example": "NYSE" }, "start_date": { "type": "string", "example": "2026-06-18" }, "filing_date": { "type": "string", "example": "2026-06-18" }, "amended_date": { "type": "string", "example": "2026-06-18" }, "price_from": { "type": "number", "example": 14 }, "price_to": { "type": "number", "example": 16 }, "offer_price": { "type": "number", "example": 0 }, "shares": { "type": "number", "example": 5500000 }, "deal_type": { "type": "string", "example": "Expected" } } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "IPOs" }, "description": { "type": "string", "example": "Historical and upcoming IPOs" }, "from": { "type": "string", "example": "2026-06-11" }, "to": { "type": "string", "example": "2026-06-18" }, "ipos": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "FCBM.US" }, "name": { "type": "string", "example": "First Carolina Financial Services, Inc." }, "exchange": { "type": "string", "example": "NYSE" }, "start_date": { "type": "string", "example": "2026-06-18" }, "filing_date": { "type": "string", "example": "2026-06-18" }, "amended_date": { "type": "string", "example": "2026-06-18" }, "price_from": { "type": "number", "example": 14 }, "price_to": { "type": "number", "example": 16 }, "offer_price": { "type": "number", "example": 0 }, "shares": { "type": "number", "example": 5500000 }, "deal_type": { "type": "string", "example": "Expected" } } } } }, "xml": { "name": "main" } } } } }, "401": { "description": "Unauthorized" } } } }, "/api/v1/public/events/earnings": { "get": { "tags": [ "Earnings", "Calendar", "Stocks" ], "description": "Historical and upcoming earnings for one or more symbols—report dates, fiscal periods, actual vs estimate EPS. Costs 2 request units per call.", "parameters": [ { "name": "from", "description": "Required. Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "symbols", "description": "List of tickers in format SYMBOL.EXCHANGE, comma-separated. Example: SAP.XETRA", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Earnings" }, "description": { "type": "string", "example": "Historical and upcoming Earnings" }, "symbols": { "type": "string", "example": "SAP.XETRA" }, "earnings": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP.XETRA" }, "report_date": { "type": "string", "example": "2026-07-23" }, "date": { "type": "string", "example": "2026-06-30" }, "before_after_market": { "type": "string", "example": "AfterMarket" }, "estimate": { "type": "number", "example": 1.77 }, "difference": { "type": "number", "example": 0 } } } } }, "xml": { "name": "main" } } }, "application/xml": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Earnings" }, "description": { "type": "string", "example": "Historical and upcoming Earnings" }, "symbols": { "type": "string", "example": "SAP.XETRA" }, "earnings": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "SAP.XETRA" }, "report_date": { "type": "string", "example": "2026-07-23" }, "date": { "type": "string", "example": "2026-06-30" }, "before_after_market": { "type": "string", "example": "AfterMarket" }, "estimate": { "type": "number", "example": 1.77 }, "difference": { "type": "number", "example": 0 } } } } }, "xml": { "name": "main" } } } } } } } }, "/api/v1/public/events/trends": { "get": { "tags": [ "Earnings Trends", "Calendar", "Stocks" ], "description": "Earnings trends of securities at covered exchanges in the requested timeframe. Uses 2 API calls per request.", "parameters": [ { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "symbols", "description": "Required: List of tickers in format SYMBOL.EXCHANGE, comma-separated. Example: AAPL.US,SAP.XETRA,OR.PA", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/events/splits": { "get": { "tags": [ "Splits", "Calendar", "Stocks" ], "description": "Split dates of securities at covered exchanges in the requested timeframe. Uses 2 API calls per request.", "parameters": [ { "name": "from", "description": "Format: YYYY-MM-DD. The start date, if not provided, today will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date, if not provided, today in 7 days will be used.", "in": "query", "schema": { "type": "string" } }, { "name": "symbols", "description": "List of tickers in format SYMBOL.EXCHANGE, comma-separated. Example: AAPL.US,SAP.XETRA,OR.PA", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/img/logos/{path}": { "get": { "tags": [ "Logos", "Stocks" ], "description": "Logos for publicly traded companies. Paths can be found in the fundamentals JSON.", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "apitoken", "in": "query", "type": "string" } ], "responses": { "200": { "description": "PNG logo image" }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Server Error" } } } }, "/api/v1/public/img/logosbycodeexchange/{codeexchange}": { "get": { "tags": [ "Logos", "Stocks" ], "description": "Logos for publicly traded companies. Paths can be found in the fundamentals JSON.", "parameters": [ { "name": "codeexchange", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "apitoken", "in": "query", "type": "string" } ], "responses": { "200": { "description": "PNG logo image" }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Server Error" } } } }, "/api/v1/public/macro/indicators": { "get": { "tags": [ "Macro" ], "description": "List all supported macro indicators.", "parameters": [], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/macro/countries": { "get": { "tags": [ "Macro" ], "description": "List covered countries with human-readable names and alpha-3 ISO codes.", "parameters": [], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/macro/{country}": { "get": { "tags": [ "Macro" ], "description": "Macro indicator time series for a country, optionally filtered to a single indicator.", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Select Country in Alpha-3 ISO format." }, { "name": "indicator", "in": "query", "description": "Select desired indicator. Default: gdp_current_usd", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/bond/{isin}": { "get": { "tags": [ "Bonds" ], "description": "Bond fundamentals for the requested ISIN.", "parameters": [ { "name": "isin", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Bond ISIN.", "example": "XS0971721963" } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/public/news/": { "get": { "tags": [ "News", "Stocks", "Cryptocurrencies", "Currencies", "Bonds", "Fonds", "ETFs", "Commodities" ], "description": "News feed for companies, stocks, currencies and much more.", "parameters": [ { "name": "from", "description": "Format: YYYY-MM-DD. The start date.", "in": "query", "schema": { "type": "string" } }, { "name": "to", "description": "YYYY-MM-DD. The end date.", "in": "query", "schema": { "type": "string" } }, { "name": "s", "description": "Format: Code.Exchange. The code for which the news are queried .", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Bad Request" } } } } } }