{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/falpha-ai/json-schema/falpha-ai-articles-list-response-schema.json",
  "title": "articles_list_response",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/falpha-ai-openapi.json#/components/schemas/articles_list_response",
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker"
    },
    "date": {
      "type": "string",
      "title": "Date",
      "description": "Requested date"
    },
    "count": {
      "type": "integer",
      "title": "Count",
      "description": "Number of articles returned"
    },
    "articles": {
      "items": {
        "$ref": "#/$defs/article_response"
      },
      "type": "array",
      "title": "Articles"
    }
  },
  "type": "object",
  "required": [
    "ticker",
    "date",
    "count",
    "articles"
  ],
  "$defs": {
    "article_response": {
      "properties": {
        "date": {
          "type": "string",
          "title": "Date",
          "description": "Crawl date (YYYY-MM-DD)"
        },
        "title": {
          "type": "string",
          "title": "Title",
          "description": "Article headline"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Score",
          "description": "Sentiment score for this article"
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source",
          "description": "Source domain"
        },
        "summary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Summary",
          "description": "AI-generated summary of the article"
        },
        "link": {
          "type": "string",
          "title": "Link",
          "description": "URL of the article"
        }
      },
      "type": "object",
      "required": [
        "date",
        "title",
        "link"
      ],
      "title": "article_response"
    }
  }
}