{"openapi":"3.0.0","info":{"title":"Marketstack","description":"The marketstack API was built to deliver worldwide stock market data (real-time, intraday and historical), together with information on stock exchanges, tickers, indices, ETFs, bonds, commodities and company fundamentals, in a simple, lightweight JSON format. Requests to the REST API are made using a straightforward HTTP GET URL structure. This documentation covers the v2 API surface.","version":"2.0.0"},"servers":[{"url":"https://api.marketstack.com","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Exchanges","description":"Look up stock exchanges worldwide by MIC code, with metadata such as operating hours, timezone, and currency."},{"name":"End-of-Day Data","description":"Retrieve daily OHLCV prices (open, high, low, close, volume) with adjusted values, scoped by exchange, ticker, or globally."},{"name":"Intraday Data","description":"Access intraday price snapshots at configurable intervals, including bid/ask data, scoped by exchange, ticker, or globally."},{"name":"Tickers","description":"Search and retrieve ticker symbols, company names, and listing details across all supported exchanges."},{"name":"Corporate Actions","description":"Look up stock splits and dividend distributions, including ex-dates, record dates, and payment dates."},{"name":"Indices","description":"Retrieve market index listings and metadata for major indices such as S&P 500, Dow Jones, and NASDAQ Composite."},{"name":"Bonds & ETFs","description":"Access bond details (coupon, maturity, yield) and ETF holdings with portfolio weights."},{"name":"Commodities","description":"Retrieve real-time and historical commodity prices for metals, energy, and agricultural products."},{"name":"Company Data / SEC","description":"Access analyst ratings, company search, and SEC EDGAR filings including XBRL facts, concepts, and frames."},{"name":"Reference Data","description":"Look up supported timezones and currencies used across the API."}],"paths":{"/v2/exchanges":{"get":{"tags":["Exchanges"],"summary":"Stock Exchanges","description":"Returns a paginated list of all 2,700+ stock exchanges in the Marketstack database, including MIC codes, location, website, and regulatory metadata. Use the `search` parameter for autocomplete-style lookups. Not all exchanges listed here have EOD or intraday data coverage — check the ticker-level `has_eod` and `has_intraday` flags to confirm data availability.","operationId":"get_stock_exchange_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}":{"get":{"tags":["Exchanges"],"summary":"Stock Exchange by MIC","description":"Returns detailed information for a single stock exchange identified by its ISO 10383 Market Identifier Code (MIC), such as `XNAS` for NASDAQ or `XNYS` for NYSE. The response includes the exchange's full legal name, LEI, operating status, country, and regulatory classification.","operationId":"get_stock_exchange_show_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/eod":{"get":{"tags":["End-of-Day Data"],"summary":"Exchange End-of-Day Data","description":"Returns paginated end-of-day price records for all tickers listed on a specific exchange, identified by its MIC code. Use the date_from and date_to parameters to narrow results to a date range, and sort to control ordering (default: newest first). Each record includes open, high, low, close, volume, and split/dividend-adjusted values.","operationId":"get_stock_exchange_eod_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangesMicEod"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/eod/latest":{"get":{"tags":["End-of-Day Data"],"summary":"Exchange Latest End-of-Day Data","description":"Returns the most recent end-of-day price records for all tickers listed on a specific exchange, identified by its MIC code. This is a convenience shortcut equivalent to querying /eod without a date range — it always returns data for the last available trading day. Each record includes open, high, low, close, volume, and adjusted values.","operationId":"get_stock_exchange_eod_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangesMicEod"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/eod/{date}":{"get":{"tags":["End-of-Day Data"],"summary":"Exchange End-of-Day Data for a Date","description":"Returns end-of-day price records for all tickers on a specific exchange for a single date, given in YYYY-MM-DD or full ISO-8601 format. Use this when you need a cross-sectional snapshot of an entire exchange on a particular trading day. If the specified date falls on a weekend or market holiday, no data is returned — use the nearest prior trading day instead.","operationId":"get_stock_exchange_eod_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"name":"date","in":"path","description":"Date for which to return end-of-day data (YYYY-MM-DD).","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangesMicEod"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/intraday":{"get":{"tags":["Intraday Data"],"summary":"Exchange Intraday Data","description":"Returns intraday price data for all symbols on the specified exchange at configurable intervals (1min, 5min, 15min, 30min, 1hour, etc.). Data includes OHLC, bid/ask prices and sizes, volume, and timestamps in ISO 8601 format. Use the `after_hours` parameter to include pre-market and after-hours trading data. Available on Professional plans and above.","operationId":"get_stock_exchange_intraday_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/intraday/latest":{"get":{"tags":["Intraday Data"],"summary":"Exchange Latest Intraday Data","description":"Returns the most recent intraday price snapshots for all tickers listed on a specific exchange, identified by its MIC code. The response includes open, high, low, close, volume, and bid/ask prices and sizes for the last available trading session. Use the interval parameter to control snapshot granularity (from 1-minute to 24-hour intervals).","operationId":"get_stock_exchange_intraday_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/intraday/{date}":{"get":{"tags":["Intraday Data"],"summary":"Exchange Intraday Data for a Date","description":"Returns intraday price snapshots for all tickers on a specific exchange for a single date, given in YYYY-MM-DD or full ISO-8601 format. Use the interval parameter to set snapshot granularity (from 1-minute to 24-hour intervals). Each record includes open, high, low, close, volume, and bid/ask prices and sizes.","operationId":"get_stock_exchange_intraday_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SymbolsRequired"},{"name":"date","in":"path","description":"Date for which to return intraday data (YYYY-MM-DD).","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/exchanges/{mic}/tickers":{"get":{"tags":["Tickers"],"summary":"Tickers for an Exchange","description":"Returns a paginated list of all ticker symbols listed on the specified exchange, identified by its MIC code. Use the search parameter to filter results by company name or symbol. Each ticker record includes listing status and flags indicating whether EOD and intraday data are available for that instrument.","operationId":"get_stock_exchange_tickers_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"mic","in":"path","description":"Market Identifier Code (MIC) of the stock exchange.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExchangeMicTickersResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}":{"get":{"tags":["Tickers"],"summary":"Ticker by Symbol","description":"Retrieves detailed information for a single ticker symbol, including the company name, exchange listing, and data-availability flags (has_eod, has_intraday). The response includes the ticker's associated stock_exchange object with MIC code, country, and timezone. Use this endpoint to verify a symbol exists and confirm what market data is available for it before querying price endpoints.","operationId":"get_ticker_show_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/eod":{"get":{"tags":["End-of-Day Data"],"summary":"Ticker End-of-Day Data","description":"Returns historical end-of-day OHLCV data for a specific ticker symbol, including both raw and split/dividend-adjusted prices. Data is available from 2000 onwards for most major tickers. Use `date_from` and `date_to` to define a date range. Results are sorted by date descending by default and paginated (default: 100 per page, max: 1,000).","operationId":"get_ticker_eod_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerEodResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/eod/latest":{"get":{"tags":["End-of-Day Data"],"summary":"Ticker Latest End-of-Day Data","description":"Returns the most recent end-of-day price record for a single ticker, identified by its symbol. The response includes open, high, low, close, volume, and split/dividend-adjusted values for the last available trading day. This is the fastest way to get a stock's closing snapshot without specifying a date or paginating through results.","operationId":"get_ticker_eod_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EODBar"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/eod/{date}":{"get":{"tags":["End-of-Day Data"],"summary":"Ticker End-of-Day Data for a Date","description":"Returns the end-of-day price record for a specific ticker on a specific date, given in YYYY-MM-DD or full ISO-8601 format (e.g. 2020-05-21T00:00:00+0000). The response includes open, high, low, close, volume, and adjusted values for that single trading day. If the specified date falls on a weekend or market holiday, no data is returned — use the nearest prior trading day instead.","operationId":"get_ticker_eod_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"name":"date","in":"path","description":"Date in YYYY-MM-DD format.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EODBar"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/intraday":{"get":{"tags":["Intraday Data"],"summary":"Ticker Intraday Data","description":"Returns paginated intraday price snapshots for a single ticker, identified by its symbol. Use date_from, date_to, and interval (from 1-minute to 24-hour) to control the date range and snapshot granularity. Each record includes open, high, low, close, volume, and bid/ask prices and sizes.","operationId":"get_ticker_intraday_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerIntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/intraday/latest":{"get":{"tags":["Intraday Data"],"summary":"Ticker Latest Intraday Data","description":"Returns the most recent intraday price snapshots for a single ticker, identified by its symbol. This is the fastest way to get a stock's latest trading-session data without specifying a date or paginating through results. Each record includes open, high, low, close, volume, and bid/ask prices and sizes at the configured interval.","operationId":"get_ticker_intraday_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerIntradayLatestResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/intraday/{date}":{"get":{"tags":["Intraday Data"],"summary":"Ticker Intraday Data for a Date","description":"Returns intraday price snapshots for a single ticker on a specific date, given in YYYY-MM-DD or full ISO-8601 format. Use the interval parameter to set snapshot granularity (from 1-minute to 24-hour intervals). If the specified date falls on a weekend or market holiday, no data is returned — use the nearest prior trading day instead.","operationId":"get_ticker_intraday_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"name":"date","in":"path","description":"Date in YYYY-MM-DD format.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/splits":{"get":{"tags":["Corporate Actions"],"summary":"Ticker Stock Splits","description":"Returns a paginated list of historical stock split events for a single ticker, identified by its symbol. Each record includes the split date, split factor (e.g. 4-for-1), and the original and adjusted share counts. Use date_from and date_to to narrow results to a specific date range.","operationId":"get_ticker_splits_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerSplitsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickers/{symbol}/dividends":{"get":{"tags":["Corporate Actions"],"summary":"Ticker Stock Dividends","description":"Returns a paginated list of historical dividend distributions for a single ticker, identified by its symbol. Each record includes the dividend amount, ex-date, record date, pay date, and declaration date. Use date_from and date_to to filter results to a specific date range.","operationId":"get_ticker_dividends_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"symbol","in":"path","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerDividendsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/eod":{"get":{"tags":["End-of-Day Data"],"summary":"End-of-Day Data","description":"You can use the API's `eod` endpoint in order to obtain end-of-day data for one or multiple stock tickers. A single or multiple comma-separated ticker symbols are passed to the API using the `symbols` parameter.\n     * \n     * \n     * **Note:**\n     * \n     * * *The EOD data has access to over 500,000 tickers from more major world-known exchanges. The full list of supported tickers and exchanges can be seen here:* [**Download**](https://marketstack.com/download/v2_eod_tickers_finnworlds_tiingo.xlsx)\n     * \n     * * *A daily updated list of all tickers accessible via Marketstack is available for download:* [**Download Ticker List**](https://marketstack.com/download/supported_tickers_2.csv)\n     * \n     * * *The V2 EOD endpoint supports data from **30+ stock exchanges**, including **NASDAQ,** **PINK, SHG, NYSE, NYSE ARCA, OTCQB,** and **BATS***\n     * \n     * * *To retrieve end-of-day data for individual tickers, you can also use the Tickers Endpoint.*\n     * \n     * * ***Ticker Symbol Formatting:** When querying ticker symbols that include a period (.), replace the period with a hyphen (-) in the intraday endpoint. **Example:BRK.B → BRK-B***\n     * * *The **LSE’s/XLON** official currency is **GBP**, however many stocks can be and are quoted in **pence (GBX)** by convention. It improves readability and pricing precision. If **LSE** equity price looks “too big” → it’s probably **pence**. Convert using **GBP = GBX / 100***\n     * \n     * **Adjusted Prices:**\n     * “**Adjusted**” prices represent stock values that have been modified to accurately reflect the impact of corporate actions such as splits and dividends. These adjustments are applied following the CRSP Calculations methodology established by the **Center for Research in Security Prices (CRSP).**","operationId":"get_eod_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EODResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/eod/latest":{"get":{"tags":["End-of-Day Data"],"summary":"Latest End-of-Day Data","description":"Returns the most recent end-of-day price records across all exchanges and tickers for the last available trading day. Use the symbols parameter to filter results to specific tickers (comma-separated). Each record includes open, high, low, close, volume, and split/dividend-adjusted values.","operationId":"get_eod_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EODResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/eod/{date}":{"get":{"tags":["End-of-Day Data"],"summary":"End-of-Day Data for a Specific Date","description":"Returns end-of-day price records across all exchanges and tickers for a specific date, given in YYYY-MM-DD or full ISO-8601 format. This is the global scope variant — use the exchange- or ticker-scoped endpoints if you need data for a single instrument or market. Results are paginated; use limit (default: 100, max: 1,000) and offset to page through large result sets.","operationId":"get_eod_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"date","in":"path","description":"Date in YYYY-MM-DD format.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EODResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/intraday":{"get":{"tags":["Intraday Data"],"summary":"Intraday Data","description":"In additional to daily end-of-day stock prices, the Marketstack API also supports intraday data with data intervals as short as one minute. Intraday prices are available for all US stock tickers included in the IEX (Investors Exchange) stock exchange.\n     * \n     * To access intraday market data, use the API’s Intraday Endpoint and specify your desired stock ticker symbols.\n     * \n     * **Notes:**\n     * \n     * * *A daily updated list of all tickers accessible via Marketstack is available for download:[**Download Ticker List**](https://marketstack.com/download/supported_tickers_2.csv)*\n     * \n     * * *You can also request intraday data for **individual ticker symbols** using the **Tickers Endpoint.***\n     * \n     * * ***Ticker Symbol Formatting:** When querying ticker symbols that include a period (.), replace the period with a hyphen (-) when using the Intraday Endpoint. **Example:** BRK.B → BRK-B*\n     * \n     * **IMPORTANT NOTE:** In the case of Intraday, Marketstack provides derived data that calculates a real-time reference price for each asset. While this is not a substitute for the TOPS Feed, we believe it will fulfill the needs of 95% of our customer base.\n     * \n     * We’re doing so because as of **February 1st, 2025**, the IEX Exchange has changed its market data policies. To receive the FULL TOPS Feed, you must now have a market data agreement signed with the IEX Exchange. This means that the parameters bidPrice, bidSize, askPrice, askSize, lastPrice, lastSize, mid, and last will all return NULL in the API response for intraday since **IEX entitlement is required** for them. If you still need to have access to TOPS Feed, please contact our customer support team before signing any contract with them.\n     * \n     * For using our derived data, there is no need to have a market data agreement signed with the IEX exchange, and there is no additional cost to the IEX Exchange.`","operationId":"get_intraday_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/intraday/latest":{"get":{"tags":["Intraday Data"],"summary":"Latest Intraday Data","description":"Returns the most recent intraday bar for the requested symbols.\n     * \n     * **Real-Time Updates:** Please note that data frequency intervals below 15 minutes (15min) are only supported if you are subscribed to the Professional Plan or higher.\n     * \n     * US equity markets close at **4:00 PM EST**, with trades at or after this time considered after-hours (retrievable with `after_hours=true`), though IEX after-hours data may be sparse, and note that intraday closing prices differ from official EOD closes, which are set via an auction process [Investopedia](https://www.investopedia.com/articles/investing/091113/auction-method-how-nyse-stock-prices-are-set.asp)","operationId":"get_intraday_latest_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/intraday/{date}":{"get":{"tags":["Intraday Data"],"summary":"Intraday Data for a Specific Date","description":"Returns intraday price snapshots across all exchanges and tickers for a specific date, given in YYYY-MM-DD or full ISO-8601 format. Use the symbols parameter to narrow results to specific tickers and interval to set snapshot granularity. Results are paginated; use limit (default: 100, max: 1,000) and offset to page through large result sets.","operationId":"get_intraday_date_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/SymbolsRequired"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Interval"},{"$ref":"#/components/parameters/AfterHours"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"date","in":"path","description":"Date in YYYY-MM-DD format.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntradayResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — symbols is required and all parameters must be valid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/timezones":{"get":{"tags":["Reference Data"],"summary":"Supported Timezones","description":"Returns a paginated list of all timezones supported by the Marketstack API, including their GMT offset and common abbreviation. Use this endpoint to identify the correct timezone string when filtering date-based queries. Timezone values returned here can be used with date parameters across EOD and intraday endpoints.","operationId":"get_timezones_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimezonesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/currencies":{"get":{"tags":["Reference Data"],"summary":"Supported Currencies","description":"Returns a paginated list of all currencies supported by the Marketstack API, including the currency code, name, and symbol. Use this endpoint to identify which currencies are available when interpreting price data from different exchanges. Each exchange's native trading currency is referenced in its metadata.","operationId":"get_currencies_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrenciesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/splits":{"get":{"tags":["Corporate Actions"],"summary":"Stock Splits","description":"Returns stock split history for one or more ticker symbols. Each record includes the split ratio (e.g., '4-for-1'), the numeric split factor, and the effective date. Data covers symbols listed on NASDAQ, NYSE, NYSE ARCA, PINK, SHG, OTCQB, and BATS. Use `date_from`/`date_to` to filter by date range. You can also retrieve split information for individual ticker symbols using the Tickers Endpoint.","operationId":"get_splits_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Symbols"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SplitsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/dividends":{"get":{"tags":["Corporate Actions"],"summary":"Stock Dividends","description":"Returns dividend payment history for one or more ticker symbols. Each record includes the dividend amount (in the stock's trading currency), the ex-dividend date, payment date, record date, declaration date, and distribution frequency (e.g., 'quarterly'). Data covers symbols on NASDAQ, NYSE, NYSE ARCA, PINK, SHG, OTCQB, and BATS. Dividend information for individual ticker symbols can also be retrieved using the **Tickers Endpoint**.","operationId":"get_dividends_v2","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Symbols"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DividendsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickerslist":{"get":{"tags":["Tickers"],"summary":"List Tickers","description":"Returns a paginated list of all ticker symbols available in the Marketstack database, across all supported exchanges. Use the search parameter to filter by company name or symbol for autocomplete-style lookups. Each record includes the ticker's exchange, listing status, and flags indicating whether EOD and intraday data are available.","operationId":"get_tickerslist","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Exchange"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickersListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/tickerinfo":{"get":{"tags":["Tickers"],"summary":"Ticker Information","description":"Returns extended company and listing information for a single ticker, including sector, industry, description, and key financial identifiers. This endpoint provides richer detail than the standard ticker lookup — use it when you need company metadata beyond the basic symbol and exchange. Pass the ticker symbol as a query parameter.","operationId":"get_tickerinfo","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"ticker","in":"query","description":"Stock ticker symbol. Example: AAPL","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerInfoResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/companyratings":{"get":{"tags":["Company Data / SEC"],"summary":"Company Analyst Ratings","description":"Returns analyst buy/sell/hold ratings and consensus price targets for a company, with over 15 years of historical data available. Use this endpoint to track rating trends and analyst performance over time. Note that this endpoint is rate-limited to 1 API call per minute.","operationId":"get_company_ratings","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"ticker","in":"query","description":"Stock ticker symbol. Example: AAPL","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"name":"rated","in":"query","description":"Filter response on buy, sell, or hold.","required":false,"schema":{"type":"string","enum":["buy","sell","hold"]}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyRatingsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/indexlist":{"get":{"tags":["Indices"],"summary":"List Market Indices","description":"Returns a paginated list of all market indices available in the Marketstack database, including major benchmarks like the S&P 500, Dow Jones, and NASDAQ Composite. Each record includes the index name, symbol, exchange, and current value.","operationId":"get_indexlist","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/indexinfo":{"get":{"tags":["Indices"],"summary":"Market Index Information","description":"Returns detailed information for a single market index, including its name, symbol, exchange, component count, and current value. Pass the index symbol as a query parameter to retrieve its metadata. Use this endpoint to look up index details before querying related ticker or EOD data.","operationId":"get_indexinfo","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"index","in":"query","description":"Market index identifier.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexInfoResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/bondlist":{"get":{"tags":["Bonds & ETFs"],"summary":"List Bonds","description":"Returns a paginated list of bonds available in the Marketstack database, organized by country of issuance. Each record includes the bond name, symbol, coupon rate, maturity date, and yield.","operationId":"get_bond_list","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"country","in":"query","description":"Filter bonds by country.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BondListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/bond":{"get":{"tags":["Bonds & ETFs"],"summary":"Bond Information","description":"Returns detailed information for a specific government bond, including coupon rate, maturity date, yield, and issuing country. The data focuses on treasury notes issued by leading countries worldwide, primarily 10-year benchmarks. Pass the bond symbol or country as a query parameter to retrieve its current and historical details.","operationId":"get_bond","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"country","in":"query","description":"Filter bonds by country.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BondInfoResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/etflist":{"get":{"tags":["Bonds & ETFs"],"summary":"List ETFs","description":"Returns a paginated list of all exchange-traded funds (ETFs) available in the Marketstack database. Each record includes the ETF name, symbol, and exchange. Note that ETF API endpoints apply a call-count multiplier of 20 toward your usage quota.","operationId":"get_etf_list","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"ticker","in":"query","description":"ETF ticker symbol.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by ETF status.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ETFListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/etfholdings":{"get":{"tags":["Bonds & ETFs"],"summary":"ETF Holdings","description":"Returns the holdings breakdown for a specific ETF, identified by its ticker symbol, including each constituent's name, weight, and share count. Use date_from and date_to to retrieve holdings for a specific date range and track portfolio composition changes over time. Note that ETF API endpoints apply a call-count multiplier of 20 toward your usage quota.","operationId":"get_etfholdings","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"ticker","in":"query","description":"ETF ticker symbol.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ETFHoldingsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/stockprice":{"get":{"tags":["Commodities"],"summary":"Real-Time Stock Price","description":"Returns real-time price data for a stock across major exchanges worldwide, including NYSE, NASDAQ, LSE, and others. Pass the ticker symbol as a query parameter to get the current bid, ask, last trade price, and volume. Use this endpoint when you need a live snapshot rather than end-of-day or interval-based intraday data.","operationId":"get_stockprice","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"ticker","in":"query","description":"Stock ticker symbol.","required":true,"schema":{"type":"string"}},{"name":"exchange","in":"query","description":"Stock exchange MIC.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockPriceResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/commodities":{"get":{"tags":["Commodities"],"summary":"Commodity Prices","description":"Get commodity prices of 70+ world-known commodities of energy, metals, industrial, agricultural, and livestock areas.\n     * \n     * **Note:**\n     * \n     * * Rate limit for 1 API call per minute is enforced on this endpoint. See the full list of available commodities in the file presented here:[**Download**](https://marketstack.com/download/marketstack-commodities.xlsx)\n     * \n     * * Historical end-of-day data (`eod`) is available for up to 15 years back, while intraday data (`intraday`) always only offers the last 10,000 entries for each of the intervals available. **Example:** For a 1-minute interval, historical intraday data is available for up to 10,000 minutes back.","operationId":"get_commodities","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"commodity_name","in":"query","description":"Name of the commodity for which to retrieve the price. Example: aluminum","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommodityResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/commoditieshistory":{"get":{"tags":["Commodities"],"summary":"Commodity Price History","description":"If you are looking for past commodity prices, you can use the Historical Commodity Prices endpoint, where you can choose specific dates and search by individual commodities. Additionally, the API offers options for daily data from the previous five years or monthly intervals using the `frequency` parameter.\n     * \n     * **Note:**\n     * \n     * * A rate limit of 1 API call per minute is enforced on this endpoint.\n     * \n     * * The recommended historical date range for a single API call is 1 year when requesting daily data. While larger ranges (up to 1.5 years) may work, retrieving data one year at a time ensures consistency.\n     * \n     * * Historical data for Commodities is available for up to 15 years in the past, though coverage varies by commodity type like **Metals:** Typically over 13 years of historical data, with some having as few as 2 years. **Energy:** Generally 15 years of coverage, though a few have up to 10 years. **Industrial:** Usually 15 years, with some limited to 10 years. **Livestock and Agricultural:** Coverage ranges from 9 to 15 years.","operationId":"get_commodities_history","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/DateFrom"},{"$ref":"#/components/parameters/DateTo"},{"name":"commodity_name","in":"query","description":"Name of the commodity.","required":true,"schema":{"type":"string"}},{"name":"frequency","in":"query","description":"Data frequency. Accepted values include: day, daily, weekly, monthly, quarterly, yearly. Defaults to day.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommodityHistoricalResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/company_name":{"get":{"tags":["Company Data / SEC"],"summary":"Search Company by Name","description":"Find Company Name by CIK code, which will provide a company name with a search by the CIK Code. The CIK code must be entered with all 10 digits, including leading zeros if any. Since the CIK code is a unique code for every company, we also have CIK code validation, meaning if the CIK code is not entered in the correct format with all of the digits, we return an error for invalid CIK format. This API endpoint returns data only in case we have an exact match in the CIK code.","operationId":"get_company_name","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"cik_code","in":"query","description":"SEC Central Index Key (CIK) code. Must be the exact 10-digit CIK including leading zeros.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyNameByCIKResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/cik_code":{"get":{"tags":["Company Data / SEC"],"summary":"Company by CIK Code","description":"Endpoint provides CIK code information with a search by company name or part of the company name. For example, if you search for “APP” in the response, the endpoint will provide information on the CIK code for all of the companies that we have in the database that have “APP” (“app”) in their name. If you enter “Example LLC”, then the API will give a response with all companies having “Example LLC” in the name, Example LLC Florida, Example LLC., Example LLC International, etc.","operationId":"get_cik_code","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"company_name","in":"query","description":"Company name (minimum 3 letters) used to search for the CIK code.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CIKSearchResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/company_facts":{"get":{"tags":["Company Data / SEC"],"summary":"Company Facts","description":"Returns the full set of XBRL financial facts reported by a company to the SEC, identified by its CIK code. Facts span all standard taxonomies (US-GAAP, IFRS, DEI) and include historical values across filing periods. Use this endpoint for detailed fundamental analysis or to build custom financial models from raw SEC EDGAR data.","operationId":"get_company_facts","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"cik_code","in":"query","description":"SEC Central Index Key (CIK) code.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyFactsByCIKResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/concept/accounts_payable":{"get":{"tags":["Company Data / SEC"],"summary":"Accounts Payable Concept","description":"Returns all SEC disclosure values for a specific XBRL concept (taxonomy and tag) reported by a single company, identified by its CIK code. Facts are grouped by unit of measure (e.g. USD, CAD), with each entry including the filing period, form type, and reported value. Use this endpoint to track a single financial metric across all of a company historical filings.","operationId":"get_accounts_payable","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"cik_code","in":"query","description":"SEC Central Index Key (CIK) code.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountsPayableResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/submissions":{"get":{"tags":["Company Data / SEC"],"summary":"SEC Submissions","description":"Returns SEC filing submissions for a specific company, identified by CIK code or company name. Each record includes the filing type (10-K, 10-Q, 8-K, etc.), filing date, acceptance date, and accession number. Use this endpoint to track a company's regulatory filing history and identify specific documents for further analysis.","operationId":"get_submissions","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"cik_code","in":"query","description":"SEC CIK code.","required":false,"schema":{"type":"string"}},{"name":"accession_number","in":"query","description":"Filing accession number.","required":false,"schema":{"type":"string"}},{"name":"cik_code_name","in":"query","description":"Company name.","required":false,"schema":{"type":"string"}},{"name":"filing_from","in":"query","description":"Filing date from (YYYY-MM-DD).","required":false,"schema":{"type":"string"}},{"name":"filing_to","in":"query","description":"Filing date to (YYYY-MM-DD).","required":false,"schema":{"type":"string"}},{"name":"report_from","in":"query","description":"Report date from (YYYY-MM-DD).","required":false,"schema":{"type":"string"}},{"name":"report_to","in":"query","description":"Report date to (YYYY-MM-DD).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionsByCIKResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}},"/v2/frames/accounts_payable/{unit}":{"get":{"tags":["Company Data / SEC"],"summary":"Accounts Payable Frames","description":"The frames API aggregates one fact for each reporting entity that is the last filed that most closely fits the calendrical period requested. This API supports annual, quarterly, and instantaneous data. This API endpoint is made for the US-GAAP taxonomy and the Accounts Payable Current type of the taxonomy.           \n     * Where the units of measure specified in the API contain a numerator and a denominator, these are separated by “-per-” such as “USD-per-shares”. Note that the default unit in XBRL is “pure”.           \n     * The period format is CY#### for annual data (duration 365 days +/- 30 days), CY####Q# for quarterly data (duration 91 days +/- 30 days), and CY####Q#I for instantaneous data. Because company financial calendars can start and end on any month or day and even change in length from quarter to quarter according to the day of the week, the frame data is assembled by the dates that best align with a calendar quarter or year. Data users should be mindful of the different reporting start and end dates for facts contained in a frame.","operationId":"get_frames_accounts_payable","parameters":[{"$ref":"#/components/parameters/AccessKey"},{"name":"unit","in":"path","description":"Unit of measure for the frame.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"name":"frame","in":"query","description":"Reporting frame. Example: CY2023Q1I.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FrameResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Validation error — one or more parameters are invalid."},"429":{"$ref":"#/components/responses/RateLimitReached"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Maintenance"}}}}},"components":{"schemas":{"ApiError":{"type":"object","description":"Standard apilayer error envelope, shared by every error response.","required":["success","error"],"properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","required":["code","type"],"properties":{"code":{"type":"integer","description":"apilayer numeric error code (the code the API returns in the body, e.g. 101 for an invalid access key — NOT the HTTP status).","example":101},"type":{"type":"string","description":"Machine-readable error type.","example":"invalid_access_key"},"info":{"type":"string","description":"Human-readable error detail.","example":"You have not supplied a valid API Access Key. [Technical Support: support@apilayer.com]"}}}}},"Pagination":{"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"count":{"type":"integer"},"total":{"type":"integer"}},"type":"object"},"PaginatedResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"type":"object"}}},"type":"object"},"EODBar":{"properties":{"open":{"type":"number","format":"float"},"high":{"type":"number","format":"float"},"low":{"type":"number","format":"float"},"close":{"type":"number","format":"float"},"volume":{"type":"number","format":"float"},"adj_open":{"type":"number","format":"float"},"adj_high":{"type":"number","format":"float"},"adj_low":{"type":"number","format":"float"},"adj_close":{"type":"number","format":"float"},"adj_volume":{"type":"number","format":"float"},"split_factor":{"type":"number","format":"float"},"dividend":{"type":"number","format":"float"},"name":{"type":"string"},"exchange_code":{"type":"string"},"asset_type":{"type":"string"},"price_currency":{"type":"string"},"symbol":{"type":"string"},"exchange":{"type":"string"},"date":{"description":"Timestamp in ISO 8601 format.","type":"string"}},"type":"object"},"IntradayBar":{"properties":{"open":{"type":"number","format":"float"},"high":{"type":"number","format":"float"},"low":{"type":"number","format":"float"},"mid":{"type":"number","format":"float"},"last_size":{"type":"integer"},"bid_size":{"type":"number","format":"float"},"bid_price":{"type":"number","format":"float"},"ask_price":{"type":"number","format":"float"},"ask_size":{"type":"number","format":"float"},"last":{"type":"number","format":"float"},"close":{"type":"number","format":"float"},"volume":{"type":"number","format":"float"},"marketstack_last":{"type":"number","format":"float"},"symbol":{"type":"string"},"exchange":{"type":"string"},"date":{"description":"Timestamp in ISO 8601 format.","type":"string"}},"type":"object"},"SplitItem":{"properties":{"split_factor":{"type":"number","format":"float"},"stock_split":{"type":"string"},"date":{"type":"string"},"symbol":{"type":"string"}},"type":"object"},"DividendItem":{"properties":{"dividend":{"type":"number","format":"float"},"payment_date":{"type":"string"},"record_date":{"type":"string"},"declaration_date":{"type":"string"},"distr_freq":{"type":"string"},"date":{"type":"string"},"symbol":{"type":"string"}},"type":"object"},"EODResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/EODBar"}}},"type":"object"},"IntradayResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/IntradayBar"}}},"type":"object"},"SplitsResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SplitItem"}}},"type":"object"},"DividendsResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/DividendItem"}}},"type":"object"},"StockPriceItem":{"properties":{"exchange_code":{"description":"Exchange code.","type":"string"},"exchange_name":{"description":"Exchange name.","type":"string"},"country":{"description":"Exchange country.","type":"string"},"ticker":{"description":"Ticker symbol.","type":"string"},"price":{"description":"Last known price.","type":"string"},"currency":{"description":"Trading currency.","type":"string"},"trade_last":{"description":"Timestamp of the last known trade.","type":"string"}},"type":"object"},"StockPriceResponse":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StockPriceItem"}}},"type":"object"},"CommodityResponse":{"properties":{"data":{"type":"array","items":{"properties":{"commodity_name":{"description":"Name of the commodity.","type":"string"},"commodity_unit":{"description":"Unit of the commodity.","type":"string"},"commodity_price":{"description":"Current price of the commodity.","type":"string"},"price_change_day":{"description":"Absolute day change.","type":"string"},"percentage_day":{"description":"Day change in percent.","type":"string"},"percentage_week":{"description":"Week change in percent.","type":"string"},"percentage_month":{"description":"Month change in percent.","type":"string"},"percentage_year":{"description":"Year change in percent.","type":"string"},"quarter1_25":{"description":"Value for the first quarter of 2025.","type":"string"},"quarter2_25":{"description":"Value for the second quarter of 2025.","type":"string"},"quarter3_25":{"description":"Value for the third quarter of 2025.","type":"string"},"quarter4_25":{"description":"Value for the fourth quarter of 2025.","type":"string"},"datetime":{"description":"Timestamp of the commodity price in ISO8601 format.","type":"string","format":"date-time"}},"type":"object"}}},"type":"object"},"CommodityHistoricalResponse":{"properties":{"result":{"properties":{"basics":{"properties":{"frequency":{"description":"Frequency of the historical data (e.g., 1day, 1month).","type":"string"}},"type":"object"},"data":{"type":"array","items":{"properties":{"commodity_name":{"description":"Name of the commodity.","type":"string"},"commodity_unit":{"description":"Unit of the commodity.","type":"string"},"commodity_prices":{"type":"array","items":{"properties":{"commodity_price":{"description":"Price of the commodity for the date.","type":"string"},"date":{"description":"Date for the price (YYYY-MM-DD or YYYY-MM for monthly).","type":"string"}},"type":"object"}}},"type":"object"}}},"type":"object"}},"type":"object"},"CompanyRatingsResponse":{"properties":{"status":{"properties":{"code":{"description":"HTTP status code.","type":"integer"},"message":{"description":"Status message.","type":"string"},"details":{"description":"Additional details.","type":"string"}},"type":"object"},"result":{"properties":{"basics":{"properties":{"company_name":{"description":"Name of the company.","type":"string"},"ticker":{"description":"Ticker symbol.","type":"string"}},"type":"object"},"output":{"description":"Analyst consensus and individual analyst ratings.","properties":{"analyst_consensus":{"properties":{"consensus_conclusion":{"description":"Overall consensus (e.g. Buy, Hold, Sell).","type":"string"},"stock_price":{"description":"Current stock price.","type":"string"},"analyst_average":{"description":"Average analyst price target.","type":"string"},"analyst_highest":{"description":"Highest analyst price target.","type":"string"},"analyst_lowest":{"description":"Lowest analyst price target.","type":"string"},"analysts_number":{"description":"Number of contributing analysts.","type":"string"},"buy":{"description":"Count of buy ratings.","type":"string"},"hold":{"description":"Count of hold ratings.","type":"string"},"sell":{"description":"Count of sell ratings.","type":"string"},"consensus_date":{"description":"Date of the consensus.","type":"string"}},"type":"object"},"analysts":{"description":"Individual analyst ratings.","type":"array","items":{"properties":{"analyst_name":{"description":"Analyst name.","type":"string"},"analyst_firm":{"description":"Analyst firm.","type":"string"},"analyst_role":{"description":"Analyst role/title.","type":"string"},"rating":{"properties":{"date_rating":{"description":"Date the rating was issued.","type":"string"},"target_date":{"description":"Target date for the price target.","type":"string"},"price_target":{"description":"Analyst price target.","type":"string"},"rated":{"description":"Rating (buy, sell, hold).","type":"string"},"conclusion":{"description":"Rating conclusion.","type":"string"}},"type":"object"}},"type":"object"}}},"type":"object"}},"type":"object"}},"type":"object"},"TickerExchange":{"description":"Stock exchange as embedded in ticker responses. Note: date fields serialize as objects here, unlike the /exchanges endpoints which return date strings.","properties":{"name":{"description":"Name of the stock exchange.","type":"string"},"acronym":{"description":"Acronym of the stock exchange.","type":"string"},"mic":{"description":"MIC identification of the exchange.","type":"string"},"country":{"description":"Country of the stock exchange.","type":"string","nullable":true},"country_code":{"description":"Three-letter country code of the exchange.","type":"string"},"city":{"description":"City where the exchange is located.","type":"string"},"website":{"description":"Website URL of the exchange.","type":"string"},"operating_mic":{"description":"Operating Market Identifier Code.","type":"string"},"oprt_sgmt":{"description":"Indicates operating MIC vs market segment MIC.","type":"string"},"legal_entity_name":{"description":"Legal entity name.","type":"string"},"exchange_lei":{"description":"Exchange Legal Entity Identifier (LEI).","type":"string"},"market_category_code":{"description":"Market category code.","type":"string"},"exchange_status":{"description":"Current status of the exchange.","type":"string"},"date_creation":{"$ref":"#/components/schemas/ExchangeDateTime"},"date_last_update":{"$ref":"#/components/schemas/ExchangeDateTime"},"date_last_validation":{"$ref":"#/components/schemas/ExchangeDateTime"},"date_expiry":{"description":"Expiry date (object or null).","properties":{"date":{"type":"string"},"timezone_type":{"type":"integer"},"timezone":{"type":"string"}},"type":"object","nullable":true},"comments":{"description":"Additional comments.","type":"string"}},"type":"object"},"Ticker":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"symbol":{"description":"Ticker symbol.","type":"string"},"has_intraday":{"description":"Indicates if intraday data is available.","type":"boolean"},"has_eod":{"description":"Indicates if end-of-day data is available.","type":"boolean"},"country":{"description":"Country of the ticker.","type":"string","nullable":true},"stock_exchanges":{"type":"array","items":{"$ref":"#/components/schemas/TickerExchange"}}},"type":"object"},"TickerResponse":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"symbol":{"description":"Ticker symbol.","type":"string"},"cik":{"description":"SEC Central Index Key.","type":"string"},"isin":{"description":"International Securities Identification Number.","type":"string"},"cusip":{"description":"U.S./Canada security identifier (CUSIP).","type":"string"},"ein_employer_id":{"description":"Employer Identification Number.","type":"string"},"lei":{"description":"Legal Entity Identifier.","type":"string"},"series_id":{"description":"Series ID.","type":"string"},"item_type":{"description":"Type of item (e.g., equity).","type":"string"},"sector":{"description":"Sector of the company.","type":"string"},"industry":{"description":"Industry of the company.","type":"string"},"sic_code":{"description":"Standard Industrial Classification code.","type":"string"},"sic_name":{"description":"SIC description.","type":"string"},"stock_exchange":{"$ref":"#/components/schemas/TickerExchange"}},"type":"object"},"TickerEodResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"symbol":{"description":"Ticker symbol.","type":"string"},"has_intraday":{"description":"Indicates if intraday data is available.","type":"boolean"},"has_eod":{"description":"Indicates if end-of-day data is available.","type":"boolean"},"country":{"description":"Country of the ticker.","type":"string"},"eod":{"type":"array","items":{"$ref":"#/components/schemas/EODBar"}}},"type":"object"}},"type":"object"},"TickerSplitsResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"properties":{"date":{"description":"Date of the split.","type":"string"},"split_factor":{"description":"Split ratio applied on the date.","type":"number"},"stock_split":{"description":"Additional stock split info (nullable).","type":"string"},"symbol":{"description":"Ticker symbol the split applies to.","type":"string"}},"type":"object"}}},"type":"object"},"TickerDividendsResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"properties":{"date":{"description":"Ex-dividend date.","type":"string"},"dividend":{"description":"Dividend amount per share.","type":"number","format":"float"},"payment_date":{"description":"Payment date of the dividend.","type":"string"},"record_date":{"description":"Record date for the dividend.","type":"string"},"declaration_date":{"description":"Declaration date for the dividend.","type":"string"},"distr_freq":{"description":"Distribution frequency (e.g., q for quarterly).","type":"string"},"symbol":{"description":"Ticker symbol the dividend applies to.","type":"string"}},"type":"object"}}},"type":"object"},"TickerIntradayResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"symbol":{"description":"Ticker symbol.","type":"string"},"has_intraday":{"description":"Indicates if intraday data is available.","type":"boolean"},"has_eod":{"description":"Indicates if end-of-day data is available.","type":"boolean"},"country":{"description":"Country of the ticker.","type":"string"},"intraday":{"type":"array","items":{"$ref":"#/components/schemas/IntradayBar"}}},"type":"object"}},"type":"object"},"TickerIntradayLatestResponse":{"$ref":"#/components/schemas/IntradayBar"},"TickersListResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"ticker":{"description":"Ticker symbol.","type":"string"},"has_intraday":{"description":"Indicates if intraday data is available.","type":"boolean"},"has_eod":{"description":"Indicates if end-of-day data is available.","type":"boolean"},"stock_exchange":{"$ref":"#/components/schemas/TickerExchange"}},"type":"object"}}},"type":"object"},"TickerInfoResponse":{"properties":{"data":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"ticker":{"description":"Ticker symbol.","type":"string"},"item_type":{"description":"Type of item (e.g., equity).","type":"string"},"sector":{"description":"Sector of the company.","type":"string"},"industry":{"description":"Industry of the company.","type":"string"},"exchange_code":{"description":"Exchange code.","type":"string"},"full_time_employees":{"description":"Number of full-time employees.","type":"string"},"ipo_date":{"description":"IPO date.","type":"string"},"date_founded":{"description":"Date founded.","type":"string"},"key_executives":{"type":"array","items":{"properties":{"name":{"description":"Executive name.","type":"string"},"salary":{"description":"Executive salary.","type":"string"},"function":{"description":"Executive function/role.","type":"string"},"exercised":{"description":"Exercised options/shares.","type":"string"},"birth_year":{"description":"Birth year.","type":"string"}},"type":"object"}},"incorporation":{"description":"State or country of incorporation.","type":"string"},"incorporation_description":{"description":"State or country of incorporation, described.","type":"string"},"start_fiscal":{"description":"Fiscal year start (MM-DD).","type":"string"},"end_fiscal":{"description":"Fiscal year end (MM-DD).","type":"string"},"mission":{"description":"Company mission statement.","type":"string"},"vision":{"description":"Company vision statement.","type":"string"},"previous_names":{"description":"Former names of the company.","type":"array","items":{"type":"string"}},"post_address":{"description":"Postal address.","properties":{"city":{"type":"string"},"street1":{"type":"string"},"street2":{"type":"string"},"postal_code":{"type":"string"},"stateOrCountry":{"type":"string"},"state_or_country_description":{"type":"string"}},"type":"object"},"stock_exchanges":{"description":"Exchanges the ticker is listed on.","type":"array","items":{"properties":{"exchange_name":{"type":"string"},"acronym1":{"type":"string"},"exchange_mic":{"type":"string"},"alpha2_code":{"type":"string"},"country":{"type":"string"},"city":{"type":"string"},"website":{"type":"string"}},"type":"object"}},"reporting_currency":{"description":"Reporting currency.","type":"string"},"address":{"properties":{"city":{"type":"string"},"street1":{"type":"string"},"street2":{"type":"string"},"postal_code":{"type":"string"},"stateOrCountry":{"type":"string"},"state_or_country_description":{"type":"string"}},"type":"object"},"phone":{"description":"Company phone number.","type":"string"},"website":{"description":"Company website.","type":"string"},"about":{"description":"Company description.","type":"string"}},"type":"object"}},"type":"object"},"Exchange":{"properties":{"name":{"description":"Name of the stock exchange.","type":"string"},"acronym":{"description":"Acronym of the stock exchange.","type":"string"},"mic":{"description":"MIC identification of the exchange.","type":"string"},"country":{"description":"Country of the stock exchange.","type":"string","nullable":true},"country_code":{"description":"Three-letter country code of the exchange.","type":"string"},"city":{"description":"City where the exchange is located.","type":"string"},"website":{"description":"Website URL of the exchange.","type":"string"},"operating_mic":{"description":"Operating Market Identifier Code.","type":"string"},"oprt_sgmt":{"description":"Indicates operating MIC vs market segment MIC.","type":"string"},"legal_entity_name":{"description":"Legal entity name.","type":"string"},"exchange_lei":{"description":"Exchange Legal Entity Identifier (LEI).","type":"string"},"market_category_code":{"description":"Market category code.","type":"string"},"exchange_status":{"description":"Current status of the exchange.","type":"string"},"date_creation":{"description":"Creation date.","type":"string"},"date_last_update":{"description":"Last update date.","type":"string"},"date_last_validation":{"description":"Last validation date.","type":"string"},"date_expiry":{"description":"Expiry date.","type":"string"},"comments":{"description":"Additional comments.","type":"string"}},"type":"object"},"ExchangeDateTime":{"description":"Date value serialized as an object (PHP DateTime) in ticker-embedded exchanges.","properties":{"date":{"description":"Date/time string (e.g. 2005-06-27 00:00:00.000000).","type":"string"},"timezone_type":{"type":"integer"},"timezone":{"type":"string"}},"type":"object"},"ExchangesResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Exchange"}}},"type":"object"},"ExchangeMicTickersResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"allOf":[{"$ref":"#/components/schemas/Exchange"},{"properties":{"tickers":{"type":"array","items":{"properties":{"name":{"description":"Company or instrument name.","type":"string"},"symbol":{"description":"Ticker symbol.","type":"string"},"has_intraday":{"description":"Indicates if intraday data is available.","type":"boolean"},"has_eod":{"description":"Indicates if end-of-day data is available.","type":"boolean"}},"type":"object"}}},"type":"object"}]}},"type":"object"},"ExchangesMicEod":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"allOf":[{"$ref":"#/components/schemas/Exchange"},{"properties":{"eod":{"type":"array","items":{"$ref":"#/components/schemas/EODBar"}}},"type":"object"}]}},"type":"object"},"Currency":{"properties":{"code":{"description":"Three-letter currency code.","type":"string"},"name":{"description":"Currency name.","type":"string"},"symbol":{"description":"Currency symbol.","type":"string"},"symbol_native":{"description":"Native currency symbol.","type":"string"}},"type":"object"},"CurrenciesResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Currency"}}},"type":"object"},"Timezone":{"properties":{"timezone":{"description":"IANA timezone name.","type":"string"},"abbr":{"description":"Standard time abbreviation.","type":"string"},"abbr_dst":{"description":"Daylight saving time abbreviation.","type":"string"}},"type":"object"},"TimezonesResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Timezone"}}},"type":"object"},"IndexListItem":{"properties":{"benchmark":{"description":"Benchmark code of the market index.","type":"string"}},"type":"object"},"IndexListResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/IndexListItem"}}},"type":"object"},"IndexInfoItem":{"properties":{"benchmark":{"description":"Benchmark name of the market index.","type":"string"},"region":{"description":"Region of the index.","type":"string"},"country":{"description":"Country of the index.","type":"string"},"price":{"description":"Current index price.","type":"string"},"price_change_day":{"description":"Absolute day change.","type":"string"},"percentage_day":{"description":"Day change in percent.","type":"string"},"percentage_week":{"description":"Week change in percent.","type":"string"},"percentage_month":{"description":"Month change in percent.","type":"string"},"percentage_year":{"description":"Year change in percent.","type":"string"},"date":{"description":"Date of the quote.","type":"string"}},"type":"object"},"IndexInfoResponse":{"type":"array","items":{"$ref":"#/components/schemas/IndexInfoItem"}},"BondListItem":{"properties":{"country":{"description":"Country supported for bonds.","type":"string"}},"type":"object"},"BondListResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BondListItem"}}},"type":"object"},"BondInfoItem":{"properties":{"region":{"description":"Region where the bond is supported.","type":"string"},"country":{"description":"Country where the bond is supported.","type":"string"},"type":{"description":"Bond tenor/type (for example 10Y).","type":"string"},"yield":{"description":"Current bond yield.","type":"string"},"price_change_day":{"description":"Price change day-over-day.","type":"string"},"percentage_week":{"description":"Weekly change percentage.","type":"string"},"percentage_month":{"description":"Monthly change percentage.","type":"string"},"percentage_year":{"description":"Yearly change percentage.","type":"string"},"date":{"description":"Quote date.","type":"string"}},"type":"object"},"BondInfoResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BondInfoItem"}}},"type":"object"},"ETFListItem":{"properties":{"ticker":{"description":"ETF ticker symbol.","type":"string"}},"type":"object"},"ETFListResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ETFListItem"}}},"type":"object"},"ETFAttributes":{"properties":{"series_name":{"description":"Name of the ETF series held by the fund.","type":"string"},"series_id":{"description":"ID of the ETF held by the fund.","type":"string"},"series_lei":{"description":"Legal Entity Identifier of the ETF series.","type":"string"},"ticker":{"description":"ETF ticker.","type":"string"},"isin":{"description":"International Securities Identification Number.","type":"string"},"date_report_period":{"description":"Start date of the report period.","type":"string"},"end_report_period":{"description":"End date of the report period.","type":"string"},"final_filing":{"description":"Indicates whether this is the final filing.","type":"boolean"}},"type":"object"},"ETFSignature":{"properties":{"date_signed":{"description":"Signature date.","type":"string"},"name_of_applicant":{"description":"Name of the applicant.","type":"string"},"signature":{"description":"Signature text.","type":"string"},"signer_name":{"description":"Name of the signer.","type":"string"},"title":{"description":"Signer's title.","type":"string"}},"type":"object"},"ETFHoldingSecurity":{"properties":{"lei":{"description":"Legal Entity Identifier.","type":"string"},"isin":{"description":"International Securities Identification Number.","type":"string"},"name":{"description":"Holding name.","type":"string"},"cusip":{"description":"U.S./Canada security identifier (CUSIP).","type":"string"},"title":{"description":"Holding title.","type":"string"},"units":{"description":"Unit type.","type":"string"},"balance":{"description":"Holding balance.","type":"string"},"currency":{"description":"Currency code.","type":"string"},"value_usd":{"description":"Holding value in USD.","type":"string"},"percent_value":{"description":"Portfolio percentage weight.","type":"string"},"asset_category":{"description":"Asset category.","type":"string"},"cash_collateral":{"description":"Cash collateral flag (Y/N).","type":"string"},"non_cash_collateral":{"description":"Non-cash collateral flag (Y/N).","type":"string"},"fair_value_level":{"description":"Fair value hierarchy level (1/2/3).","type":"string"},"invested_country":{"description":"ISO country code where the security is invested.","type":"string"},"issuer_category":{"description":"Issuer category (e.g., CORP).","type":"string"},"loan_by_fund":{"description":"Security on loan by the fund (Y/N).","type":"string"},"payoff_profile":{"description":"Payoff profile (e.g., Long, Short).","type":"string"},"restricted_sec":{"description":"Restricted security flag (Y/N).","type":"string"}},"type":"object"},"ETFHoldingsResponse":{"properties":{"basics":{"properties":{"fund_name":{"description":"Fund name.","type":"string"},"file_number":{"description":"SEC file number.","type":"string"},"cik":{"description":"SEC CIK of the main trust fund.","type":"string"},"reg_lei":{"description":"Legal Entity Identifier of the fund.","type":"string"}},"type":"object"},"output":{"properties":{"attributes":{"$ref":"#/components/schemas/ETFAttributes"},"signature":{"$ref":"#/components/schemas/ETFSignature"},"holdings":{"type":"array","items":{"properties":{"investment_security":{"$ref":"#/components/schemas/ETFHoldingSecurity"}},"type":"object"}}},"type":"object"}},"type":"object"},"CIKItem":{"properties":{"cik_code":{"description":"Company CIK code.","type":"string"},"company_name":{"description":"Company name.","type":"string"},"ein":{"description":"Employer Identification Number.","type":"string"},"sic":{"description":"Standard Industrial Classification.","type":"string"},"sic_description":{"description":"SIC description.","type":"string"}},"type":"object"},"CIKSearchResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CIKItem"}}},"type":"object"},"CompanyNameByCIKResponse":{"properties":{"data":{"properties":{"cik_code":{"description":"Company CIK code.","type":"string"},"company_name":{"description":"Company name.","type":"string"},"ein":{"description":"Employer Identification Number.","type":"string"},"sic":{"description":"Standard Industrial Classification code.","type":"string"},"sic_description":{"description":"SIC description.","type":"string"},"phone":{"description":"Company registered phone.","type":"string"},"incorporation_state":{"description":"Abbreviation of the incorporation state.","type":"string"},"addresses":{"description":"Mailing and business addresses.","properties":{"mailing":{"properties":{"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"state_or_country":{"type":"string"},"zip_code":{"type":"string"}},"type":"object"},"business":{"properties":{"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"state_or_country":{"type":"string"},"zip_code":{"type":"string"}},"type":"object"}},"type":"object"}},"type":"object"}},"type":"object"},"SubmissionsByCIKResponse":{"properties":{"data":{"properties":{"cik_code":{"description":"SEC Central Index Key (zero-padded).","type":"string"},"company_name":{"description":"Company name.","type":"string"},"entity_type":{"description":"Entity type (e.g. operating).","type":"string"},"ein":{"description":"Employer Identification Number.","type":"string"},"sic":{"description":"Standard Industrial Classification code.","type":"string"},"sic_description":{"description":"SIC description.","type":"string"},"owner_org":{"description":"SEC owner organization classification.","type":"string"},"insider_transaction_for_owner_exists":{"description":"Whether insider transactions exist for the owner (0 or 1).","type":"integer"},"insider_transaction_for_issuer_exists":{"description":"Whether insider transactions exist for the issuer (0 or 1).","type":"integer"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"description":{"description":"Company description.","type":"string"},"website":{"description":"Company website.","type":"string"},"investor_website":{"description":"Investor relations website.","type":"string"},"category_filer":{"description":"Filer category (e.g. Large accelerated filer).","type":"string"},"fiscal_year_end":{"description":"Fiscal year end (MMDD).","type":"string"},"incorporation_state_or_country":{"description":"State or country of incorporation.","type":"string"},"incorporation_state_or_country_desc":{"description":"State or country of incorporation, described.","type":"string"},"phone":{"description":"Company phone number.","type":"string"},"addresses":{"description":"Mailing and business addresses.","properties":{"mailing":{"properties":{"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"state_or_country":{"type":"string"},"zip_code":{"type":"string"},"state_or_country_desc":{"type":"string"}},"type":"object"},"business":{"properties":{"street1":{"type":"string"},"street2":{"type":"string"},"city":{"type":"string"},"state_or_country":{"type":"string"},"zip_code":{"type":"string"},"state_or_country_desc":{"type":"string"}},"type":"object"}},"type":"object"},"former_names":{"description":"Previous company names with active date ranges.","type":"array","items":{"properties":{"name":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"type":"object"}},"filings":{"description":"Recent filings and paginated file references.","properties":{"recent":{"description":"Most recent filings as index-aligned parallel arrays.","properties":{"accession_number":{"type":"array","items":{"type":"string"}},"filing_date":{"type":"array","items":{"type":"string","format":"date"}},"report_date":{"type":"array","items":{"type":"string","format":"date"}},"acceptance_date_time":{"type":"array","items":{"type":"string","format":"date-time"}},"act":{"type":"array","items":{"type":"string"}},"form":{"type":"array","items":{"type":"string"}},"file_number":{"type":"array","items":{"type":"string"}},"film_number":{"type":"array","items":{"type":"string"}},"core_type":{"type":"array","items":{"type":"string"}},"size":{"type":"array","items":{"type":"integer"}},"primary_document":{"type":"array","items":{"type":"string"}},"primary_doc_description":{"type":"array","items":{"type":"string"}}},"type":"object"},"files":{"description":"References to older, paginated filing files.","type":"array","items":{"properties":{"name":{"type":"string"},"filing_count":{"type":"integer"},"filing_from":{"type":"string","format":"date"},"filing_to":{"type":"string","format":"date"}},"type":"object"}}},"type":"object"}},"type":"object"}},"type":"object"},"CompanyFactsByCIKResponse":{"properties":{"data":{"properties":{"cik":{"description":"SEC Central Index Key.","type":"integer"},"company_name":{"description":"Company name.","type":"string"},"facts":{"description":"XBRL concepts keyed by taxonomy (e.g. dei, us-gaap), then by concept tag. Keys are dynamic; the value shape below is consistent.","type":"object","additionalProperties":{"description":"A taxonomy (e.g. us-gaap), keyed by concept tag.","type":"object","additionalProperties":{"description":"A single XBRL concept.","properties":{"label":{"description":"Human-readable concept label.","type":"string"},"description":{"description":"Concept definition.","type":"string"},"units":{"description":"Fact values keyed by unit of measure (e.g. USD, shares).","type":"object","additionalProperties":{"type":"array","items":{"properties":{"fp":{"description":"Fiscal period (e.g. Q3, FY).","type":"string","nullable":true},"fy":{"description":"Fiscal year.","type":"integer","nullable":true},"start":{"description":"Period start date. Present on duration concepts (e.g. revenue, expenses); absent on point-in-time concepts.","type":"string","format":"date"},"end":{"description":"Period end date.","type":"string","format":"date"},"val":{"description":"Reported value.","type":"number"},"accn":{"description":"Accession number of the source filing.","type":"string"},"form":{"description":"Filing form type (e.g. 10-K, 10-Q).","type":"string"},"filed":{"description":"Filing date.","type":"string","format":"date"},"frame":{"description":"CY frame identifier (present when comparable).","type":"string"}},"type":"object"}}}},"type":"object"}}}},"type":"object"}},"type":"object"},"AccountsPayableResponse":{"properties":{"data":{"properties":{"cik":{"description":"SEC Central Index Key.","type":"integer"},"company_name":{"description":"Company name.","type":"string"},"us-gaap":{"description":"US GAAP concepts keyed by tag (e.g. AccountsPayableCurrent). Keys are dynamic; value shape is consistent.","type":"object","additionalProperties":{"properties":{"label":{"description":"Human-readable concept label.","type":"string"},"description":{"description":"Concept definition.","type":"string"},"units":{"description":"Fact values keyed by unit of measure (e.g. USD).","type":"object","additionalProperties":{"type":"array","items":{"properties":{"fp":{"description":"Fiscal period (e.g. Q3, FY).","type":"string","nullable":true},"fy":{"description":"Fiscal year.","type":"integer","nullable":true},"start":{"description":"Period start date (duration concepts).","type":"string","format":"date"},"end":{"description":"Period end date.","type":"string","format":"date"},"val":{"description":"Reported value.","type":"number"},"accn":{"description":"Accession number of the source filing.","type":"string"},"form":{"description":"Filing form type (e.g. 10-K, 10-Q).","type":"string"},"filed":{"description":"Filing date.","type":"string","format":"date"},"frame":{"description":"CY frame identifier (when comparable).","type":"string"}},"type":"object"}}}},"type":"object"}}},"type":"object"}},"type":"object"},"FrameResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"properties":{"taxonomy":{"description":"Taxonomy (e.g., us-gaap).","type":"string"},"tag":{"description":"Tag name (e.g., AccountsPayableCurrent).","type":"string"},"ccp":{"description":"Calendar period code (e.g., CY2023Q1I).","type":"string"},"uom":{"description":"Unit of measure (e.g., USD).","type":"string"},"label":{"description":"Concept label.","type":"string"},"description":{"description":"Concept description.","type":"string"},"frame_data":{"type":"array","items":{"properties":{"accn":{"description":"Accession number.","type":"string"},"cik":{"description":"SEC Central Index Key.","type":"integer"},"entityName":{"description":"Entity name.","type":"string"},"end":{"description":"End date (YYYY-MM-DD).","type":"string"},"val":{"description":"Value.","type":"number"}},"type":"object"}}},"type":"object"}},"type":"object"}},"parameters":{"AccessKey":{"name":"access_key","in":"query","description":"Your API access key, which can be found in your account dashboard.","required":true,"schema":{"type":"string"}},"Symbols":{"name":"symbols","in":"query","description":"Comma-separated list of one or more stock ticker symbols. Example: AAPL,MSFT","required":true,"schema":{"type":"string"}},"SymbolsRequired":{"name":"symbols","in":"query","description":"Comma-separated list of one or more stock ticker symbols (required for this endpoint). Example: AAPL,MSFT","required":true,"schema":{"type":"string"}},"Exchange":{"name":"exchange","in":"query","description":"Filter results by stock exchange, identified by its MIC. Example: XNAS","required":false,"schema":{"type":"string"}},"Sort":{"name":"sort","in":"query","description":"Sort order of the results by date.","required":false,"schema":{"type":"string","default":"DESC","enum":["DESC","ASC","desc","asc"]}},"DateFrom":{"name":"date_from","in":"query","description":"Filter results from a specific start date. [Format: YYYY-MM-DD]","required":false,"schema":{"type":"string","format":"date"}},"DateTo":{"name":"date_to","in":"query","description":"Filter results up to a specific end date. [Format: YYYY-MM-DD]","required":false,"schema":{"type":"string","format":"date"}},"Interval":{"name":"interval","in":"query","description":"Intraday data interval. Available values: 1min, 5min, 10min, 15min, 30min, 1hour, 3hour, 6hour, 12hour, 24hour. Default: 1hour","required":false,"schema":{"type":"string","default":"1hour","enum":["1min","5min","10min","15min","30min","1hour","3hour","6hour","12hour","24hour"]}},"AfterHours":{"name":"after_hours","in":"query","description":"Include after-hours data in intraday results.","required":false,"schema":{"type":"boolean"}},"Search":{"name":"search","in":"query","description":"Use this parameter to get autocomplete suggestions by specifying a search term.","required":false,"schema":{"type":"string"}},"Limit":{"name":"limit","in":"query","description":"Specify a limit of results to return. Default value is 100.","required":false,"schema":{"type":"integer","default":100,"maximum":1000,"minimum":1}},"Offset":{"name":"offset","in":"query","description":"Specify an offset for pagination. Default offset value is 0.","required":false,"schema":{"type":"integer","default":0,"minimum":0}}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Your Marketstack API access key, found in your account dashboard.","name":"access_key","in":"query"}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"account_on_hold":{"summary":"account_on_hold","value":{"success":false,"error":{"code":107,"type":"account_on_hold","info":"Your account currently has open invoices and API has been automatically disabled. Please settle your open balance or downgrade to the Free Plan to restore API access. [Support: support@apilayer.com]"}}},"invalid_access_key":{"summary":"invalid_access_key","value":{"success":false,"error":{"code":101,"type":"invalid_access_key","info":"You have not supplied a valid API Access Key. [Technical Support: support@apilayer.com]"}}},"missing_access_key":{"summary":"missing_access_key","value":{"success":false,"error":{"code":101,"type":"missing_access_key","info":"You have not supplied an API Access Key. [Required format: access_key=YOUR_ACCESS_KEY]"}}},"inactive_user":{"summary":"inactive_user","value":{"success":false,"error":{"code":102,"type":"inactive_user","info":"Permission denied - User not active."}}}}}}},"Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"https_access_restricted":{"summary":"https_access_restricted","value":{"success":false,"error":{"code":105,"type":"https_access_restricted","info":"Access Restricted - Your current Subscription Plan does not support HTTPS Encryption."}}},"function_access_restricted":{"summary":"function_access_restricted","value":{"success":false,"error":{"code":105,"type":"function_access_restricted","info":"Access Restricted - Your current Subscription Plan does not support this API Function."}}},"api_access_blocked":{"summary":"api_access_blocked","value":{"success":false,"error":{"code":104,"type":"api_access_blocked","info":"Your API access has been temporarily disabled. Please upgrade your Subscription Plan or contact support."}}}}}}},"NotFound":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"invalid_api_function":{"summary":"invalid_api_function","value":{"success":false,"error":{"code":103,"type":"invalid_api_function","info":"This API Function does not exist."}}},"404_not_found":{"summary":"404_not_found","value":{"success":false,"error":{"code":404,"type":"404_not_found","info":"404 - The requested resource could not be found. Please try again or contact support."}}}}}}},"RateLimitReached":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"usage_limit_reached":{"summary":"usage_limit_reached","value":{"success":false,"error":{"code":104,"type":"usage_limit_reached","info":"Your monthly usage limit has been reached. Please upgrade your Subscription Plan."}}},"daily_usage_limit_reached":{"summary":"daily_usage_limit_reached","value":{"success":false,"error":{"code":104,"type":"daily_usage_limit_reached","info":"Your daily usage limit has been reached. Please try again tomorrow or upgrade your subscription plan."}}},"fair_use_limit_reached":{"summary":"fair_use_limit_reached","value":{"success":false,"error":{"code":104,"type":"fair_use_limit_reached","info":"Your fair use limit has been reached. [Please contact support: support@apilayer.com]"}}},"rate_limit_reached":{"summary":"rate_limit_reached","value":{"success":false,"error":{"code":106,"type":"rate_limit_reached","info":"You have exceeded the maximum rate limitation allowed on your subscription plan. Please refer to the \"Rate Limits\" section of the API Documentation for details. "}}}}}}},"InternalError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"internal_error":{"summary":"internal_error","value":{"success":false,"error":{"code":0,"type":"internal_error","info":"An error has occured. [Technical Support: support@apilayer.com]"}}}}}}},"Maintenance":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"examples":{"maintenance_mode":{"summary":"maintenance_mode","value":{"success":false,"error":{"code":503,"type":"maintenance_mode","info":""}}}}}}}}}}