--- title: Instrument Data | Clear Street description: Use instrument, market data, financial statement, and news endpoints for research and discovery. --- The Instruments and Market Data APIs provide a single surface for both reference data and prices. Use the instruments endpoints to pull corporate events, analyst consensus, company fundamentals, and financial statements going back multiple years. Use the market-data endpoints for latest quotes and daily open, high, low, volume data. Additionally you can keep up the latest with the News API. ## Instrument Events and Metrics | **Name** | **Method** | **Path** | **Description** | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | [All Instrument Events](https://docs.clearstreet.com/api/resources/v1/subresources/instruments/subresources/events/methods/get_all_instrument_events) | `GET` | `/v1/instruments/events` | Returns all earnings, dividends, stock splits, and IPOs across instruments, grouped by event date | | [Instrument Events](https://docs.clearstreet.com/api/resources/v1/subresources/instruments/subresources/events/methods/get_instrument_events) | `GET` | `/v1/instruments/{instrument_id}/events` | Returns earnings, dividends, stock splits, and IPOs across instruments, grouped by event date | | [Analyst ratings & price targets](https://docs.clearstreet.com/api/resources/v1/subresources/instruments/subresources/analyst-reporting/methods/get_instrument_analyst_consensus) | `GET` | `/v1/instruments/{instrument_id}/analyst-reporting` | Returns the latest available analyst consensus snapshot, including rating distribution and aggregate price targets. | | [Fundamentals](https://docs.clearstreet.com/api/resources/v1/subresources/instruments/subresources/fundamentals/methods/get_instrument_fundamentals) | `GET` | `/v1/instruments/{instrument_id}/fundamentals` | Returns supplemental company data for instruments including sector, industry, market cap, TTM EPS, P/E, beta, volume, 52-week range. | ## Instrument Financial Statements | **Name** | **Method** | **Path** | **Description** | | -------------------- | ---------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | | Income Statements | `GET` | `/v1/instruments/{instrument_id}/income-statements` | Returns income statement rows with revenue, expenses, operating income, net income, EPS, and share count fields. | | Balance Sheets | `GET` | `/v1/instruments/{instrument_id}/balance-sheets` | Returns balance sheet rows with assets, liabilities, equity, debt, and net debt fields. | | Cash Flow Statements | `GET` | `/v1/instruments/{instrument_id}/cash-flow-statements` | Returns cash flow statement rows with operating, investing, financing, cash position, capital expenditure, and free cash flow fields. | ## Instrument Market Data | **Name** | **Method** | **Path** | **Description** | | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | ------------------------------- | ---------------------------------------------------------------------------------------- | | [Snapshots](https://docs.clearstreet.com/api/resources/v1/subresources/market-data/subresources/snapshot/methods/get_snapshots) | `GET` | `/v1/market-data/snapshot` | Returns latest quote, last trade, and session change metrics for one or more instruments | | [Daily Summaries](https://docs.clearstreet.com/api/resources/v1/subresources/market-data/subresources/daily-summary/methods/get_daily_summaries) | `GET` | `/v1/market-data/daily-summary` | Returns daily OHLV and current price summaries for up to 100 instrument UUID | --- ## News Use the [news endpoint](https://docs.clearstreet.com/api/resources/v1/subresources/news/methods/get_news) `GET v1/news` for timely market news and press releases, filtered by instrument, publisher, sector, date range, or text search, with instrument associations included in each result. ### Use Cases | **Use Case** | **Description** | **Example** | | -------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Watchlist news | Show one combined news feed across every instrument in a user’s watchlist. | GET /v1/news?instrument\_ids={id1},{id2},{id3} | | Portfolio or position monitoring | Help users understand news affecting instruments they currently hold or trade. | Query news for the instruments in a user’s active positions. | | Research and discovery | Support keyword-based research across titles, article text, and associated security IDs. | GET /v1/news?search\_query=earnings%20guidance | | Publisher-specific feeds | Include preferred publishers or exclude noisy sources. | GET /v1/news?include\_publishers=Reuters,Bloomberg | | Sector news dashboard | Power sector overview pages or market pulse widgets. | GET /v1/news?sectors=TECHNOLOGY,FINANCIAL\_SERVICES | | Press release monitoring | Separate company-issued announcements from general market news. | GET /v1/news?news\_type=PRESS\_RELEASE\&instrument\_id=528ec5c3-cdbf-447c-b995-ec6c83cfbc02 | | Time-windowed market recap | Build daily, intraday, or session-specific news recaps. | GET /v1/news?from=2026-05-03\&to=2026-05-03 | | Alerting and notifications | Notify users when new articles match a saved instrument or keyword filter. | Query with from={last\_checked\_at} for followed instruments. | | AI or summary workflows | Feed relevant articles into an assistant, summary card, or research copilot. | Retrieve recent instrument news, then summarize catalysts, risks, or themes. | ### Query Parameters | **Parameter** | **Description** | | ----------------------- | ----------------------------------------------------------------------------------- | | exclude\_publishers | Comma-separated publishers to exclude. | | from, to | Inclusive publish-time range. Accepts YYYY-MM-DD or RFC3339 datetime. | | include\_publishers | Comma-separated publishers to include. Mutually exclusive with exclude\_publishers. | | instrument\_ids | Comma-separated instrument UUIDs. | | news\_type | Filter by NEWS or PRESS\_RELEASE. | | page\_size, page\_token | Cursor-based pagination. | | search\_query | Free-text search across title, article text, and associated security IDs. | | sectors | Comma-separated sectors to filter by. | ---