Raw schema
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"minimum": 1,
"maximum": 20,
"description": "Number of news items per page (1-20). Default: 15"
},
"offset": {
"type": "number",
"minimum": 0,
"description": "Pagination offset. 0 = first page with pinned news. Default: 0"
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Article language. 'en' = English, 'zh' = Chinese. Default: 'en'"
},
"sources": {
"type": "string",
"description": "Comma-separated source filter. Valid values: wsj, nyt, bloomberg, ft, cnbc, reuters, yahoo. Omit for all sources."
},
"marketOnly": {
"type": "boolean",
"description": "Filter to market/finance-relevant stories only, dropping general politics, sports and lifestyle coverage. Use when the user wants pure market news. Default: false (all news)."
},
"clusterDedupe": {
"type": "boolean",
"description": "When several outlets report the SAME story, fold them into ONE card and list the others under 'Also reported by' (cross-source corroboration) instead of returning near-duplicate cards. Keeps the feed concise. Default: true. Set false only when you need each outlet's separate wording/framing, or want to gauge how many outlets covered a story."
},
"aiSummary": {
"type": "boolean",
"description": "Return a concise AI-written summary (~80 words) in place of each article's full body. Use it to scan many stories quickly or to save tokens; keep false (full text) when you need to quote or deeply analyze the complete article. Default: false."
},
"liveOnly": {
"type": "boolean",
"description": "Return only real-time live-coverage cards (breaking, fast-moving updates) and hide long-form analysis articles (Bloomberg Latest and the outlets' standalone articles). Use when the user wants the latest developments as they happen. Default: false (includes both live cards and articles)."
},
"before": {
"type": "string",
"description": "Time cursor for forward pagination. Pass the 'time' value of the last item from a previous response. Format: 'YYYY-MM-DD HH:MM:SS ET'"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}