> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Market News > [OpenAPI JSON Spec](/docs/output/v1_stocks_market-news_get.json) Retrieve market news articles within a specified time range, optionally filtered by symbol. Supports pagination and flexible filtering. Use cases: - Market news aggregation and monitoring - Stock-specific news tracking - News analysis and sentiment tracking - Media applications and news feeds Data & semantics: - start_time: Start time (Unix timestamp in seconds, required) - end_time: End time (Unix timestamp in seconds, required) - symbol: Stock symbol filter (optional, e.g., AAPL, TSLA) - topic: Topic filter (optional, lowercase). Valid values: - blockchain, earnings, economy_fiscal, economy_macro, economy_monetary - energy_transportation, finance, financial_markets, ipo, life_sciences - manufacturing, mergers_and_acquisitions, real_estate, retail_wholesale, technology - source: Media source filter (optional). Valid values: - Reuters, AP News, BBC, The New York Times, The Washington Post, The Guardian - Bloomberg, The Wall Street Journal, Financial Times, CNBC, Fortune - Forbes, TechCrunch, MIT Technology Review, The Verge - WIRED, South China Morning Post, Nikkei Asia, Business Wire, PR Newswire - sort_by_type: Sort by type - PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (optional, default: PUBLISHED_TIME) - sort_by: Sort order - "ASC" or "DESC" (optional, default: "DESC") - limit: Maximum number of results (optional, default: 10, max: 100) - offset: Pagination offset (optional, default: 0, must be >= 0) ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/market-news openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/stocks/market-news: get: tags: - Stock summary: Get Market News description: > [OpenAPI JSON Spec](/docs/output/v1_stocks_market-news_get.json) Retrieve market news articles within a specified time range, optionally filtered by symbol. Supports pagination and flexible filtering. Use cases: - Market news aggregation and monitoring - Stock-specific news tracking - News analysis and sentiment tracking - Media applications and news feeds Data & semantics: - start_time: Start time (Unix timestamp in seconds, required) - end_time: End time (Unix timestamp in seconds, required) - symbol: Stock symbol filter (optional, e.g., AAPL, TSLA) - topic: Topic filter (optional, lowercase). Valid values: - blockchain, earnings, economy_fiscal, economy_macro, economy_monetary - energy_transportation, finance, financial_markets, ipo, life_sciences - manufacturing, mergers_and_acquisitions, real_estate, retail_wholesale, technology - source: Media source filter (optional). Valid values: - Reuters, AP News, BBC, The New York Times, The Washington Post, The Guardian - Bloomberg, The Wall Street Journal, Financial Times, CNBC, Fortune - Forbes, TechCrunch, MIT Technology Review, The Verge - WIRED, South China Morning Post, Nikkei Asia, Business Wire, PR Newswire - sort_by_type: Sort by type - PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (optional, default: PUBLISHED_TIME) - sort_by: Sort order - "ASC" or "DESC" (optional, default: "DESC") - limit: Maximum number of results (optional, default: 10, max: 100) - offset: Pagination offset (optional, default: 0, must be >= 0) parameters: - description: Stock symbol filter (optional) example: AAPL in: query name: symbol schema: type: string - description: Topic filter (optional) example: earnings in: query name: topic schema: type: string enum: - blockchain - earnings - economy_fiscal - economy_macro - economy_monetary - energy_transportation - finance - financial_markets - ipo - life_sciences - manufacturing - mergers_and_acquisitions - real_estate - retail_wholesale - technology - description: Media source filter (optional, e.g. Reuters, Bloomberg, CNBC) example: Bloomberg in: query name: source schema: type: string - description: Start time (Unix timestamp in seconds) example: 1704067200 in: query name: start_time required: true schema: type: integer format: int64 - description: End time (Unix timestamp in seconds) example: 1735689600 in: query name: end_time required: true schema: type: integer format: int64 - description: >- Sort by type: PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (default: PUBLISHED_TIME) example: PUBLISHED_TIME in: query name: sort_by_type schema: type: string enum: - PUBLISHED_TIME - OVERALL_SENTIMENT_SCORE - RELEVANCE_SCORE - description: 'Sort order: ASC or DESC (default: DESC)' example: DESC in: query name: sort_by schema: type: string enum: - ASC - DESC - description: 'Maximum number of results (1-100, default: 10)' in: query name: limit schema: type: integer minimum: 1 maximum: 100 default: 10 - description: 'Pagination offset (>=0, default: 0)' in: query name: offset schema: type: integer minimum: 0 default: 0 responses: '200': description: List of market news articles content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.MarketNewsArticle' type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.MarketNewsArticle: properties: authors: items: type: string type: array banner_image: type: string category_within_source: type: string id: type: integer overall_sentiment_label: type: string overall_sentiment_score: type: number publish_time: type: integer source: type: string source_domain: type: string summary: type: string tickers: items: $ref: '#/components/schemas/model.MarketNewsTickerEntry' type: array time_published: type: string title: type: string topics: items: $ref: '#/components/schemas/model.MarketNewsTopicEntry' type: array url: type: string type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.MarketNewsTickerEntry: properties: relevance_score: type: string ticker: type: string ticker_sentiment_label: type: string ticker_sentiment_score: type: string type: object model.MarketNewsTopicEntry: properties: relevance_score: type: string topic: type: string type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````