Deal book
deal_bookThe deal book of the one team the caller's key reads; every row names that team (team_id, team_name). Without deal_id this lists deals ordered by their ranking window first (financing open, early stage, not confirmed, financing closed, cancelled) and the chosen sort inside it, filterable by stage, window, country_code (ISO country codes), sector, status, eca, eca_named (only deals naming an export credit agency), minimum contract value (min_value_usd), and free text (q); sort by score (default), last_activity, value, or first_seen; paged with limit (default 50, maximum 100) and offset, with the exact total. Dismissed deals are excluded unless status asks for them, and the portfolio rows a desk holds back by default (closed, cancelled, older than the stale window of 18 months by default, own bank, domestic; score_hidden true) are off the page unless include_hidden is true, and score_own_bank marks the rows where your own bank is a lender. A row carrying merged_into was found to be a duplicate and folded into the deal that field names: read that deal instead, and expect this one to be dismissed. Each row carries its window (score_window and its label), the band word and reason count behind its score (score_band, score_reason_count), the confirmed state over its linked findings (state, state_label), the newest quote backed event date (event_date, null when no source stated one), the lender names on the deal (lenders), and the two derived sentences a desk reads first: angle (why the row is on the list) and ask (what is still to be financed, read from the confirmed state, the window, the agencies and the lenders; a row whose state no source confirmed reads State not confirmed by a source yet). With deal_id (the deal_id field of list rows) it returns one deal in full: score_reasons, one plain sentence per scoring component saying which fact it matched, alongside parties carrying entity_id and node_id where bound, the cited timeline with press quotes (each entry also carrying the state its quote confirmed, the confirming passage and the event date), lifecycle events, sources each carrying source_tier (1 a primary source, 2 trade press, 3 an aggregator, which is also where an unclassified publisher lands) and its tier_label, the deal summary (summary_lines: three lines generated from the cited findings by fixed rules, not by a model, each with the finding and quote behind every field it states), the analyst's own next_action, and economics.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text filter over deal names and summaries. | |
| eca | No | Keep only deals naming this export credit agency. | |
| sort | No | Ranking, default score. | |
| limit | No | Page size, default 50, maximum 100. | |
| stage | No | Keep only these lifecycle stages. | |
| offset | No | Rows to skip, default 0. | |
| sector | No | Keep only these sectors. | |
| status | No | Keep only these statuses; dismissed deals appear only when asked for here. | |
| window | No | Keep only these ranking windows: financing_open, early_stage, not_confirmed, financing_closed, cancelled. | |
| deal_id | No | A deal_id from the list; when present the other arguments are not used. | |
| eca_named | No | Keep only deals naming an export credit agency. | |
| country_code | No | Keep only deals in these ISO country codes. | |
| min_value_usd | No | Keep only deals at or above this contract value in USD. | |
| include_hidden | No | Also serve the rows a desk holds back by default (closed, cancelled, older than the stale window, own bank, domestic); off by default. |