> ## Documentation Index > Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt > Use this file to discover all available pages before exploring further. # Stock News > Retrieve a stock's news list, publication times, and body-availability status. ## Plan Access | Plan | Available | | - | :-: | | Free | ❌ | | Starter | ❌ | | Professional | ✅ | | Full-Market Plans (A-Shares, HK Stocks, US Stocks) | ✅ | | Enterprise | ✅ | ## Notes * The news list does not include article bodies; use `news_id` to query details. `from` and `to` must either both be provided or both be omitted. ## Supported Markets | Market | Examples | | - | - | | US Stocks | AAPL.US | | HK Stocks | 700.HK | | A-Shares | 600519.SH | ## Request Parameters | Parameter | Required | Description | | - | :-: | - | | `symbol` | Yes | Stock symbol | | `type` | No | Product type; currently supports `stock` | | `limit` | No | Maximum number of records to return; default `50`, range `1–200` | | `from` | No | Start date in `YYYY-MM-DD` format | | `to` | No | End date in `YYYY-MM-DD` format | `from` and `to` must either both be provided or both be omitted. ## Request Example ```bash theme={null} curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.tickdb.ai/v1/fundamentals/news?symbol=AAPL&type=stock&limit=20" ``` ## Response Fields The table below lists fields in `data`; an outer `code=0` indicates success. | Field | Description | | - | - | | symbol | Stock symbol. | | limit | Maximum number of records for this request. | | news | News list. | | └─ news\_id | News ID, which can be used to query details. | | └─ title | News title. | | └─ description | News summary. | | └─ published\_at | Publication time as an RFC 3339 date-time string in UTC. | | └─ has\_body | Whether an article body is available. | The news list returns `news_id`, title, summary, publication time, and body-availability status without embedding the article body. Use `news_id` to query news details. ## OpenAPI ````yaml openapi.en.yaml GET /v1/fundamentals/news openapi: 3.1.0 info: title: TickDB API description: TickDB unified real-time market data API via REST and WebSocket. version: 1.0.3 contact: email: support@tickdb.ai servers: - url: https://api.tickdb.ai description: Production server security: - ApiKeyAuth: [] paths: /v1/fundamentals/news: get: tags: - fundamentals-events summary: Stock News description: >- Retrieve a stock's news list, publication times, and body-availability status. operationId: getFundamentalsNews parameters: - $ref: '#/components/parameters/SymbolQuery' - $ref: '#/components/parameters/TypeQuery' - $ref: '#/components/parameters/NewsLimitQuery' - $ref: '#/components/parameters/FromQuery' - $ref: '#/components/parameters/ToQuery' responses: '200': $ref: '#/components/responses/NewsResponse' default: $ref: '#/components/responses/NewsErrorResponse' components: parameters: SymbolQuery: name: symbol in: query required: true schema: type: string examples: - AAPL - '700' - '600519' - AAPL.US - 700.HK - 600519.SH description: Stock symbol TypeQuery: name: type in: query required: false schema: type: string enum: - stock description: Product type; currently supports `stock` NewsLimitQuery: name: limit in: query required: false schema: type: integer minimum: 1 maximum: 200 default: 50 description: Maximum number of records to return; default `50`, range `1–200` FromQuery: name: from in: query required: false schema: type: string format: date examples: - '2024-01-01T00:00:00.000Z' description: Start date in `YYYY-MM-DD` format ToQuery: name: to in: query required: false schema: type: string format: date examples: - '2026-12-31T00:00:00.000Z' description: End date in `YYYY-MM-DD` format responses: NewsResponse: description: Stock News response. content: application/json: schema: $ref: '#/components/schemas/NewsEnvelope' NewsErrorResponse: description: >- Error response. Common HTTP statuses include 400 (invalid parameters), 401 (authentication failed), 403 (permission or quota restriction), 404 (no matching data), 429 (rate limit), and 503 (service temporarily unavailable). content: application/json: schema: $ref: '#/components/schemas/NewsErrorEnvelope' schemas: NewsEnvelope: type: object required: - code - data properties: code: type: integer const: 0 data: $ref: '#/components/schemas/NewsData' additionalProperties: false NewsErrorEnvelope: type: object required: - code - message properties: code: description: TickDB API business error code; may be an integer or string. oneOf: - type: integer - type: string message: type: string description: Error description. error: type: string description: >- Compatibility error identifier; present only in some error responses. data: description: Optional error context. oneOf: - type: 'null' - type: object additionalProperties: true - type: array items: {} additionalProperties: true NewsData: type: object required: - symbol - limit - news properties: symbol: type: string description: Stock symbol. limit: type: integer description: Maximum number of records for this request. news: type: array description: News list. items: $ref: '#/components/schemas/NewsItem' additionalProperties: false NewsItem: type: object required: - news_id - title - description - published_at - has_body properties: news_id: type: string pattern: ^[1-9][0-9]*$ description: News ID, which can be used to query details. title: type: string description: News title. description: type: - string - 'null' description: News summary. published_at: type: string format: date-time description: Publication time as an RFC 3339 date-time string in UTC. has_body: type: boolean description: Whether an article body is available. additionalProperties: false securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.