Signal
TOOLnews_search
Semantic search over company and market news — storylines, the events inside them, and attributed statements.
- Coverage
- US / CN / JP
- Billing
- Per call · 0.2 cr / call
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | optional | Semantic query, in English. At least one of query, theme, ticker, since or until is required. |
| theme | string | optional | A theme word, resolved to the nearest canonical theme. Not valid with search_type=claims. |
| ticker | string | string[] | optional | Exact symbol(s): one symbol, an array, or a comma-separated string; several act as an OR filter. US bare (AAPL), A-shares .SH / .SZ (600519.SH), Japan .T (7203.T). Names are not resolved here — use ticker_lookup first. |
| since | string | optional | ISO 8601. Keeps events with time_event on or after this instant. |
| until | string | optional | ISO 8601. Keeps events with time_event before this instant. |
| search_type | string | optional | all, events, or claims — attributed statements only. Default all. |
| order_by | string | optional | relevance, event_time (newest event first) or create_time (most recently ingested first). Default relevance. |
| top_k | int | optional | Story count, max 50. Default 10. |
Example
Arguments
{ "ticker": "NVDA", "query": "export controls", "top_k": 2 }Response
query=export controls | ticker=NVDA | count=2
## Stories
1. **US Tightens AI Chip Export Curbs on China** · 48 nodes · 2026-05-30T23:59:59Z → 2026-08-31T07:05:38Z
The US is expanding restrictions on China's AI chip access by limiting remote use and investigating smuggling, while Nvidia re-enters the Chinese market and Taiwan indicts nine for illegal exports.
2. **Nvidia, Samsung, SK Hynix Expand HBM Deals** · 36 nodes · 2026-06-01T10:57:00Z → 2026-09-02T06:30:00Z
Nvidia is deepening ties with Samsung and SK Hynix through long-term supply agreements and advanced HBM4E development.
## Events (`story` = the numbered story above)
| story | event_time | summary | type | entity | score | sources | source | source_url |
|---|---|---|---|---|---|---|---|---|
| 1 | 2026-05-31T20:09:53Z | The U.S. Department of Commerce moved to close a loophole that may have allowed exports of advanced AI chips … to Chinese entities located outside China. | regulatory_action | U.S. Department of Commerce | 5 | 6 | reuters.com | https://www.reuters.com/… |
## Claims
| event_time | type | claimant | target | summary | sources | source |
|---|---|---|---|---|---|---|
| 2026-06-28T23:59:59Z | corporate_disclosure | Jensen Huang | Nvidia | Nvidia CEO Jensen Huang stated that before export controls, Nvidia had about 95% market share in China … | 4 | mynorthwest.com |Trimmed: One event and one claim shown of the twenty-odd returned; some table columns dropped.
Limits
| Limit | Value | Past it |
|---|---|---|
| top_k (stories) | 1–50, default 10 | — |
| Response size | 52 KB (~20k tokens) | Lowest-ranked stories dropped; header says how many |
| Claims by theme | Not supported | Claims block skipped, header says so |
Errors
Invalid arguments are refused before the tool runs; the rest arrive as a tool failure whose text is the message. The four shapes are on MCP server.
| When | You get | Do |
|---|---|---|
| No query, theme, ticker, since or until | Upstream 400 passed through | Add at least one filter |
| Unknown ticker | "No results." with count=0 | Resolve with ticker_lookup first |
| top_k, search_type or order_by out of range | Invalid arguments | Use the listed values |
Notes
- Three sections come back: Stories (each storyline once), Events (flat, with a story column pointing back), and Claims (analyst actions, corporate guidance, official remarks). sources counts corroborating reports.
- Lowest-ranked stories are dropped to fit the response budget; the header line says how many were omitted.
Endpoint, client setup and billing are common to all tools. For details, please refer to MCP server.