> ## Documentation Index > Fetch the complete documentation index at: https://docs.financialdatasets.ai/llms.txt > Use this file to discover all available pages before exploring further. # Market News > Get the latest broad market news covering macro, rates, earnings, geopolitics, energy, crypto, and other market-moving topics. ### Overview The Market News API lets you pull recent broad market news. Articles cover AI, macro, rates, earnings, geopolitics, energy, crypto, and other market-moving topics. To get started, please create an account and grab your API key at [financialdatasets.ai](https://financialdatasets.ai). You will use the API key to authenticate your API requests. ### Coverage | Tickers | Years of Coverage | Updated | | ------- | ----------------- | ----------------- | | 10,000+ | 2+ years | Within 10 minutes | ### Getting Started There are only 3 steps for making a successful API call: 1. Add your API key to the header of the request as `X-API-KEY`. 2. Omit the `ticker` query param to get broad market news. Optionally add `limit` to control the number of results. 3. Execute the API request. ### Example ```python Market News theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} import requests # add your API key to the headers headers = { "X-API-KEY": "your_api_key_here" } # omit ticker to get broad market news limit = 10 # create the URL url = ( f'https://api.financialdatasets.ai/news' f'?limit={limit}' ) # make API request response = requests.get(url, headers=headers) # parse market news from the response news = response.json().get('news') ``` ## OpenAPI ````yaml GET /news openapi: 3.0.1 info: title: Financial Datasets API description: >- Stock market API with real-time and historical financial data for 27,000+ tickers over 30+ years. Financial statements, equity prices, insider trades, SEC filings, and more. version: 1.0.0 license: name: MIT url: https://opensource.org/licenses/MIT contact: name: API Support url: mailto:support@financialdatasets.ai email: support@financialdatasets.ai termsOfService: https://financialdatasets.ai/terms-of-use servers: - url: https://api.financialdatasets.ai/ description: Production server security: - X-API-KEY: [] tags: - name: Financial Statements description: Access to income statements, balance sheets, and cash flow statements - name: Market Data description: Real-time and historical price data - name: Company Information description: Company facts like ticker, name, and description - name: Earnings description: Earnings data and related information - name: News description: Real-time and historical news articles - name: SEC Filings description: SEC filings and regulatory documents - name: Insider Trades description: Insider trading activity and transactions - name: Institutional Holdings description: SEC-direct 13F equity holdings of institutional investment managers - name: Index Funds description: >- ETF and index-fund holdings, weights, and the funds that hold a given security - name: Financial Metrics description: Financial ratios, metrics, and key performance indicators - name: Macroeconomics description: Real-time and historical macroeconomic data like interest rates - name: KPIs description: Sector-specific operational KPIs extracted from earnings releases. paths: /news: get: tags: - News summary: Get news articles description: >- Get recent news articles for a specific company or the broad market. Pass a ticker for company-specific news, or omit the ticker for general market news. Articles are sourced from RSS feeds of publishers like The Motley Fool, Investing.com, Reuters, and more. operationId: getNews parameters: - name: ticker in: query description: The ticker symbol of the company. Omit for broad market news. required: false schema: type: string - name: limit in: query description: 'The maximum number of news articles to return (default: 5, max: 10).' required: false schema: type: integer default: 5 maximum: 10 responses: '200': description: News articles response content: application/json: schema: $ref: '#/components/schemas/NewsResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/PaymentRequiredError' '404': $ref: '#/components/responses/NotFoundError' components: schemas: NewsResponse: type: object properties: news: type: array items: $ref: '#/components/schemas/News' News: type: object properties: ticker: type: string description: The ticker symbol. title: type: string description: The title of the news article. source: type: string description: The source of the news article. date: type: string format: date description: The date the news article was published. url: type: string format: uri description: The URL of the news article. ErrorResponse: type: object properties: error: type: string description: A short error message. message: type: string description: A more detailed error message. responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Bad Request message: Invalid request parameters UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Unauthorized message: Invalid API key provided PaymentRequiredError: description: The request requires a paid subscription content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Payment Required message: >- This endpoint requires a paid subscription. Please upgrade your plan. NotFoundError: description: The specified resource was not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Not Found message: Ticker XXXX not found securitySchemes: X-API-KEY: type: apiKey name: X-API-KEY description: API key for authentication. in: header ````