> ## 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 TradingView News > [OpenAPI JSON Spec](/docs/output/v1_stocks_tv-news_get.json) Retrieve TradingView news stories within a time range, optionally filtered by symbol or industry. Data & semantics: - start_time: Start time (Unix timestamp in seconds, required unless updated_after and updated_before are supplied) - end_time: End time (Unix timestamp in seconds, same requirement as start_time) - symbol: Canonical symbol filter (optional, e.g., AAPL, BRK.B, 0700.HK); mutually exclusive with industry - industry: FMP industry filter (optional); mutually exclusive with symbol - limit: Maximum number of results (optional, 1–500, default: 10) Results are ordered by published_at DESC (newest first). Update polling selects rows within [updated_after, updated_before), ordered by updated_at ASC, story_id ASC. Times are Unix seconds; both bounds are required together and the whole table may be polled with a bounded window. start_time/end_time (on published_at) and symbol/industry intersect that window. updated_at advances when a story's title, content or related symbols change, and each item carries story_id — TradingView's natural key, no surrogate id — plus RFC3339 updated_at. Pass pagination.cursor back unchanged with the same window and filters; limit may change on retry. An omitted cursor with has_more=false means the window is drained. Start each new window without the old cursor. Offset paging is not available in window mode. This is current-state polling, not a snapshot or deletion feed: overlap windows and reconcile delayed writes. See docs/api/update-polling.md. Valid industry values (exact match required): Advertising Agencies; Aerospace & Defense; Agricultural - Machinery; Agricultural Farm Products; Agricultural Inputs; Airlines, Airports & Air Services; Aluminum; Apparel - Footwear & Accessories; Apparel - Manufacturers; Apparel - Retail; Asset Management; Asset Management - Bonds; Asset Management - Cryptocurrency; Asset Management - Global; Asset Management - Income; Asset Management - Leveraged; Auto - Dealerships; Auto - Manufacturers; Auto - Parts; Auto - Recreational Vehicles; Banks; Banks - Diversified; Banks - Regional; Beverages - Alcoholic; Beverages - Non-Alcoholic; Beverages - Wineries & Distilleries; Biotechnology; Broadcasting; Business Equipment & Supplies; Chemicals; Chemicals - Specialty; Coal; Communication Equipment; Computer Hardware; Conglomerates; Construction; Construction Materials; Consulting Services; Consumer Electronics; Copper; Department Stores; Discount Stores; Diversified Utilities; Drug Manufacturers - General; Drug Manufacturers - Specialty & Generic; Education & Training Services; Electrical Equipment & Parts; Electronic Gaming & Multimedia; Engineering & Construction; Entertainment; Environmental Services; Financial - Capital Markets; Financial - Conglomerates; Financial - Credit Services; Financial - Data & Stock Exchanges; Financial - Diversified; Financial - Mortgages; Food Confectioners; Food Distribution; Furnishings, Fixtures & Appliances; Gambling, Resorts & Casinos; General Transportation; General Utilities; Gold; Grocery Stores; Hardware, Equipment & Parts; Home Improvement; Household & Personal Products; Independent Power Producers; Industrial - Distribution; Industrial - Infrastructure Operations; Industrial - Machinery; Industrial - Pollution & Treatment Controls; Industrial - Specialties; Industrial Materials; Information Technology Services; Insurance - Brokers; Insurance - Diversified; Insurance - Life; Insurance - Property & Casualty; Insurance - Reinsurance; Insurance - Specialty; Integrated Freight & Logistics; Internet Content & Information; Investment - Banking & Investment Services; Leisure; Luxury Goods; Manufacturing - Metal Fabrication; Manufacturing - Miscellaneous; Manufacturing - Textiles; Manufacturing - Tools & Accessories; Marine Shipping; Media & Entertainment; Medical - Care Facilities; Medical - Devices; Medical - Diagnostics & Research; Medical - Distribution; Medical - Equipment & Services; Medical - Healthcare Information Services; Medical - Healthcare Plans; Medical - Instruments & Supplies; Medical - Pharmaceuticals; Medical - Specialties; Oil & Gas Drilling; Oil & Gas Energy; Oil & Gas Equipment & Services; Oil & Gas Exploration & Production; Oil & Gas Integrated; Oil & Gas Midstream; Oil & Gas Refining & Marketing; Other Precious Metals; Packaged Foods; Packaging & Containers; Paper, Lumber & Forest Products; Personal Products & Services; Publishing; REIT - Diversified; REIT - Healthcare Facilities; REIT - Hotel & Motel; REIT - Industrial; REIT - Mortgage; REIT - Office; REIT - Residential; REIT - Retail; REIT - Specialty; Railroads; Real Estate - Development; Real Estate - Diversified; Real Estate - Services; Regulated Electric; Regulated Gas; Regulated Water; Renewable Utilities; Rental & Leasing Services; Residential Construction; Restaurants; Security & Protection Services; Semiconductors; Shell Companies; Silver; Software - Application; Software - Infrastructure; Software - Services; Solar; Specialty Business Services; Specialty Retail; Staffing & Employment Services; Steel; Technology Distributors; Telecommunications Services; Tobacco; Travel Lodging; Travel Services; Trucking; Uranium; Waste Management ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/tv-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/tv-news: get: tags: - Stock summary: Get TradingView News description: >- [OpenAPI JSON Spec](/docs/output/v1_stocks_tv-news_get.json) Retrieve TradingView news stories within a time range, optionally filtered by symbol or industry. Data & semantics: - start_time: Start time (Unix timestamp in seconds, required unless updated_after and updated_before are supplied) - end_time: End time (Unix timestamp in seconds, same requirement as start_time) - symbol: Canonical symbol filter (optional, e.g., AAPL, BRK.B, 0700.HK); mutually exclusive with industry - industry: FMP industry filter (optional); mutually exclusive with symbol - limit: Maximum number of results (optional, 1–500, default: 10) Results are ordered by published_at DESC (newest first). Update polling selects rows within [updated_after, updated_before), ordered by updated_at ASC, story_id ASC. Times are Unix seconds; both bounds are required together and the whole table may be polled with a bounded window. start_time/end_time (on published_at) and symbol/industry intersect that window. updated_at advances when a story's title, content or related symbols change, and each item carries story_id — TradingView's natural key, no surrogate id — plus RFC3339 updated_at. Pass pagination.cursor back unchanged with the same window and filters; limit may change on retry. An omitted cursor with has_more=false means the window is drained. Start each new window without the old cursor. Offset paging is not available in window mode. This is current-state polling, not a snapshot or deletion feed: overlap windows and reconcile delayed writes. See docs/api/update-polling.md. Valid industry values (exact match required): Advertising Agencies; Aerospace & Defense; Agricultural - Machinery; Agricultural Farm Products; Agricultural Inputs; Airlines, Airports & Air Services; Aluminum; Apparel - Footwear & Accessories; Apparel - Manufacturers; Apparel - Retail; Asset Management; Asset Management - Bonds; Asset Management - Cryptocurrency; Asset Management - Global; Asset Management - Income; Asset Management - Leveraged; Auto - Dealerships; Auto - Manufacturers; Auto - Parts; Auto - Recreational Vehicles; Banks; Banks - Diversified; Banks - Regional; Beverages - Alcoholic; Beverages - Non-Alcoholic; Beverages - Wineries & Distilleries; Biotechnology; Broadcasting; Business Equipment & Supplies; Chemicals; Chemicals - Specialty; Coal; Communication Equipment; Computer Hardware; Conglomerates; Construction; Construction Materials; Consulting Services; Consumer Electronics; Copper; Department Stores; Discount Stores; Diversified Utilities; Drug Manufacturers - General; Drug Manufacturers - Specialty & Generic; Education & Training Services; Electrical Equipment & Parts; Electronic Gaming & Multimedia; Engineering & Construction; Entertainment; Environmental Services; Financial - Capital Markets; Financial - Conglomerates; Financial - Credit Services; Financial - Data & Stock Exchanges; Financial - Diversified; Financial - Mortgages; Food Confectioners; Food Distribution; Furnishings, Fixtures & Appliances; Gambling, Resorts & Casinos; General Transportation; General Utilities; Gold; Grocery Stores; Hardware, Equipment & Parts; Home Improvement; Household & Personal Products; Independent Power Producers; Industrial - Distribution; Industrial - Infrastructure Operations; Industrial - Machinery; Industrial - Pollution & Treatment Controls; Industrial - Specialties; Industrial Materials; Information Technology Services; Insurance - Brokers; Insurance - Diversified; Insurance - Life; Insurance - Property & Casualty; Insurance - Reinsurance; Insurance - Specialty; Integrated Freight & Logistics; Internet Content & Information; Investment - Banking & Investment Services; Leisure; Luxury Goods; Manufacturing - Metal Fabrication; Manufacturing - Miscellaneous; Manufacturing - Textiles; Manufacturing - Tools & Accessories; Marine Shipping; Media & Entertainment; Medical - Care Facilities; Medical - Devices; Medical - Diagnostics & Research; Medical - Distribution; Medical - Equipment & Services; Medical - Healthcare Information Services; Medical - Healthcare Plans; Medical - Instruments & Supplies; Medical - Pharmaceuticals; Medical - Specialties; Oil & Gas Drilling; Oil & Gas Energy; Oil & Gas Equipment & Services; Oil & Gas Exploration & Production; Oil & Gas Integrated; Oil & Gas Midstream; Oil & Gas Refining & Marketing; Other Precious Metals; Packaged Foods; Packaging & Containers; Paper, Lumber & Forest Products; Personal Products & Services; Publishing; REIT - Diversified; REIT - Healthcare Facilities; REIT - Hotel & Motel; REIT - Industrial; REIT - Mortgage; REIT - Office; REIT - Residential; REIT - Retail; REIT - Specialty; Railroads; Real Estate - Development; Real Estate - Diversified; Real Estate - Services; Regulated Electric; Regulated Gas; Regulated Water; Renewable Utilities; Rental & Leasing Services; Residential Construction; Restaurants; Security & Protection Services; Semiconductors; Shell Companies; Silver; Software - Application; Software - Infrastructure; Software - Services; Solar; Specialty Business Services; Specialty Retail; Staffing & Employment Services; Steel; Technology Distributors; Telecommunications Services; Tobacco; Travel Lodging; Travel Services; Trucking; Uranium; Waste Management parameters: - description: Canonical symbol filter (optional) example: AAPL in: query name: symbol schema: type: string - description: >- Filter to stories with a symbol in this exact FMP industry. Mutually exclusive with symbol. in: query name: industry schema: type: string - description: >- Start time (Unix seconds); required unless updated_after/updated_before are given, in which case it narrows published_at as an optional filter example: 1704067200 in: query name: start_time schema: type: integer format: int64 - description: >- End time (Unix seconds); required unless updated_after/updated_before are given, in which case it narrows published_at as an optional filter example: 1735689600 in: query name: end_time schema: type: integer format: int64 - description: 'Maximum number of results (1–500, default: 10)' in: query name: limit schema: type: integer minimum: 1 maximum: 500 default: 10 - description: Inclusive story update bound (Unix seconds); requires updated_before in: query name: updated_after schema: type: integer format: int64 - description: >- Exclusive story update bound (Unix seconds); must exceed updated_after in: query name: updated_before schema: type: integer format: int64 - description: Opaque update-window continuation; requires an update window in: query name: cursor schema: type: string responses: '200': description: List of TradingView news stories content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.TVNewsArticle' type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '408': description: Request timeout content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '503': description: Update polling not available on this backend yet content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $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.TVNewsArticle: properties: content: type: string industries: items: type: string type: array provider: type: string published_at: type: integer story_id: type: string story_url: description: >- StoryURL is the public TradingView permalink for this story. The page there may gate the body behind TradingView's free trial — the full text is already in Content. Empty only when the stored path is empty. example: >- https://www.tradingview.com/news/DJN_DN20260727010758:0-asian-equities-slide/ type: string symbols: items: type: string type: array title: type: string updated_at: description: >- UpdatedAt is the row's data update time, RFC3339 UTC with fractional seconds. Only update-window reads carry it (docs/api/update-polling.md). example: '2026-09-09T03:00:00.123456Z' 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.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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.