Public API (read-only)

OpenAPI: openapi.json — API catalog (RFC 9727): /.well-known/api-catalog

OAuth/OIDC discovery (metadata for agents): /.well-known/oauth-protected-resource (RFC 9728), /.well-known/openid-configuration, /.well-known/oauth-authorization-server, /.well-known/jwks.json, /.well-known/http-message-signatures-directory (Web Bot Auth JWKS + signed directory).

Public JSON/RSS endpoints need no token; operator routes use the admin token as documented below.

MCP Server Card (SEP-1649): /.well-known/mcp/server-card.json — discovery only; streamable MCP is not active yet.

GET /api/news/today

Try — Query: date, source, page, pageSize, q

GET /api/stocks/:symbol

Example (FPT) — Query: date

GET /api/news/explain

Query u = canonical article URL.

GET /api/hsx/vnindex-chart

Query range = 1w | 1m | 1y

GET /api/notify/status

Try

GET /rss/today

Try — Query: source

GET /sitemap.xml

Try

GET /robots.txt

Try

GET /health

Try — Liveness JSON for all services above.

GET /api/intel/daily

Query date = YYYY-MM-DD (Vietnam report day). Returns JSON snapshot from R2 when available (written each refresh).

← Trang chủ