{"openapi":"3.1.0","info":{"title":"VN Market News — public HTTP API","version":"1.0.0","description":"Machine-readable overview of public read endpoints (no authentication)."},"servers":[{"url":"https://stocknews.orangecloud.vn"}],"paths":{"/api/news/today":{"get":{"summary":"JSON feed for a report day","parameters":[{"name":"date","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"source","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"q","in":"query","schema":{"type":"string"}}]}},"/api/stocks/{symbol}":{"get":{"summary":"Stock insight JSON","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}]}},"/api/news/explain":{"get":{"summary":"AI impact explanation for an article URL","parameters":[{"name":"u","in":"query","required":true,"schema":{"type":"string","format":"uri"}}]}},"/api/hsx/vnindex-chart":{"get":{"summary":"VNINDEX chart HTML fragment","parameters":[{"name":"range","in":"query","required":true,"schema":{"type":"string","enum":["1w","1m","1y"]}}]}},"/api/notify/status":{"get":{"summary":"Telegram notify configuration status (non-secret)"}},"/rss/today":{"get":{"summary":"RSS 2.0 for today","parameters":[{"name":"source","in":"query","schema":{"type":"string"}}]}},"/sitemap.xml":{"get":{"summary":"XML sitemap"}},"/robots.txt":{"get":{"summary":"robots.txt"}},"/health":{"get":{"summary":"Liveness JSON"}},"/api/intel/daily":{"get":{"summary":"Investor desk snapshot (Fear/Greed, sectors, smart-money proxy)","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}]}}}}