{
  "name": "WEMS News Investment External API",
  "version": "v1",
  "base_url": "https://news.sun-bd.com/api/public/v1",
  "authentication": {
    "type": "api_key",
    "header": "X-Api-Key",
    "required_for": [
      "/catalog",
      "/articles",
      "/market/assets",
      "/market/candles",
      "/analytics/overview"
    ]
  },
  "documentation": {
    "html": "https://news.sun-bd.com/docs/news-api.html",
    "features": "https://news.sun-bd.com/features/news.html",
    "web_app": "https://news.sun-bd.com/app/"
  },
  "response_envelope": {
    "success": "boolean",
    "data": "object or array payload when success is true",
    "error": "object with code/message when success is false",
    "timestamp": "UTC response timestamp",
    "traceId": "request trace identifier when available"
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/status",
      "auth_required": false,
      "description": "Service status and documentation links."
    },
    {
      "method": "GET",
      "path": "/catalog",
      "auth_required": true,
      "description": "Machine-readable resource catalog."
    },
    {
      "method": "GET",
      "path": "/articles",
      "auth_required": true,
      "query": ["page", "page_size", "category", "keyword"],
      "description": "Paged published article list."
    },
    {
      "method": "GET",
      "path": "/articles/{id}",
      "auth_required": true,
      "description": "Published article detail."
    },
    {
      "method": "GET",
      "path": "/market/assets",
      "auth_required": true,
      "query": ["category"],
      "description": "Market asset summaries."
    },
    {
      "method": "GET",
      "path": "/market/candles",
      "auth_required": true,
      "query": ["asset_id", "interval", "days"],
      "description": "OHLC candle data."
    },
    {
      "method": "GET",
      "path": "/analytics/overview",
      "auth_required": true,
      "description": "Content and traffic overview."
    }
  ]
}