entity_news_list
Read-onlyIdempotent
List full published news events across a company's or issuer's full entity graph (the company, its security_issuers, their bonds/shares, and emissions under the company). Accepts a company OR issuer TokenBel id; resolves the entity and returns enriched news events with aggregated links and tags. Supports filtering by event_types, impact_types, and a date_from/date_to range, plus cursor-based pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field/tool names, it is not an RFC UUID and normally has no hyphens. Company or issuer id, usually discovered via search_by_name. | |
| limit | No | Max results per page (default 20, max 50). | |
| date_to | No | Optional inclusive upper bound on the event date (ISO YYYY-MM-DD). | |
| date_from | No | Optional inclusive lower bound on the event date (ISO YYYY-MM-DD). | |
| event_types | No | Optional filter on news_event.event_type. Valid values: company_news, share_event, bond_event, token_event, emission_event, corporate_action, payment_event, default_risk, financial_report, regulatory_update, tax_update, market_infrastructure, deposit_event, precious_metal_event, currency_market_event, market_data, other. Case-insensitive. | |
| impact_types | No | Optional filter on news_event.impact_type. Valid values: positive, neutral, negative, mixed. Case-insensitive. | |
| cursor_event_id | No | Opaque pagination cursor part 1 (the last event id) from the next_cursor returned by a prior call; pass both cursor parts together. | |
| cursor_published_at | No | Opaque pagination cursor part 2 (the last event sort-key timestamp) from the next_cursor returned by a prior call; pass both cursor parts together. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| limit | Yes | ||
| events | Yes | ||
| filters | Yes | ||
| issuer_name | Yes | ||
| issuer_uuid | Yes | ||
| next_cursor | Yes | ||
| company_name | Yes | ||
| company_uuid | Yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. | |
| requested_uuid | Yes | TokenBel internal identifier: opaque hexadecimal string, usually 8 characters such as "78c7e502"; despite uuid field names, it is not an RFC UUID and normally has no hyphens. | |
| requested_entity_type | Yes |