How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Clear Street Instrument Data API

Retrieve instrument analytics, market data, news, and related reference data.

Clear Street Instrument Data API is one of 23 APIs that Clear Street publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Instrument Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and a changelog.

This API exposes 10 operations across 10 paths, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version 2025-10-31.

Requests are made against 3 base URLs: https://api.clearstreet.com, https://api-dev.clearstreet.com, http://localhost:5001.

10 operations 10 paths 39 schemas 10 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-10-31
Base URL
https://api.clearstreet.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Clear Street Instrument Data API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 10

Across 10 paths, the API surfaces 10 operations — 10 GET. Each is listed below with its method, path, parameters, and response codes.

Instrument Data 10

Retrieve instrument analytics, market data, news, and related reference data.

GET
/v1/instruments/events
Get All Instrument Events
get_all_instrument_events 4 params → 200400500
GET
/v1/instruments/{instrument_id}/analyst-reporting
Get Instrument Analyst Consensus
get_instrument_analyst_consensus 3 params → 200404500
GET
/v1/instruments/{instrument_id}/balance-sheets
Get Instrument Balance Sheet Statements
get_instrument_balance_sheet_statements 5 params → 200404500
GET
/v1/instruments/{instrument_id}/cash-flow-statements
Get Instrument Cash Flow Statements
get_instrument_cash_flow_statements 5 params → 200404500
GET
/v1/instruments/{instrument_id}/events
Get Instrument Events
get_instrument_events 3 params → 200404500
GET
/v1/instruments/{instrument_id}/fundamentals
Get Instrument Fundamentals
get_instrument_fundamentals 1 param → 200400404500
GET
/v1/instruments/{instrument_id}/income-statements
Get Instrument Income Statements
get_instrument_income_statements 5 params → 200404500
GET
/v1/market-data/daily-summary
Get Daily Aggregate Summaries
get_daily_summaries 1 param → 200400
GET
/v1/market-data/snapshot
Get Snapshots
get_snapshots 1 param → 200400404
GET
/v1/news
Get News
get_news 10 params → 200400500

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are InstrumentBalanceSheetStatement (58 properties), InstrumentCashFlowStatement (45 properties), InstrumentIncomeStatement (37 properties), InstrumentFundamentals (15 properties). Each schema is shown below with its type and property counts.

InstrumentBalanceSheetStatement
object
A quarterly balance sheet statement for an instrument.
58 properties 6 required
DailySummary
object
Daily aggregate (OHLV) summary for a single instrument. Returned by GET /market-data/daily-summary. Every field except instrumentid and notapplicable is Option…
8 properties 1 required
InstrumentIncomeStatementList
array
InstrumentEventIpoItem
object
IPO event in the all-events date grouping response.
7 properties
InstrumentIdOrSymbol
string
Instrument identifier: either an instrument UUID or a symbol (symbol for equities, OSI for options). Non-UUID inputs are resolved server-side.
InstrumentBalanceSheetStatementList
array
InstrumentDividendEvent
object
Represents a dividend event for an instrument
8 properties 2 required
ReportTime
string
Earnings report timing: before market open or after market close
ErrorDetails
array
PriceTarget
object
Analyst price target statistics
4 properties 4 required
SnapshotGreeks
object
Theoretical price and Greeks for an options snapshot. All values are per share; no contract multiplier is applied.
8 properties 8 required
InstrumentSplitEvent
object
Represents a stock split event for an instrument
4 properties 4 required
AnalystRating
string
Analyst rating category
InstrumentEventEnvelope
object
Unified envelope for the all-events response.
9 properties 2 required
SnapshotQuote
object
L1 quote fields for a market data snapshot.
5 properties
InstrumentEventsByDate
object
Instrument events for a single date.
2 properties 2 required
NewsInstrument
object
Instrument associated with a news item.
3 properties 1 required
AnalystDistribution
object
Analyst recommendation distribution
5 properties 5 required
ResponseMetadata
object
Metadata for the response. This will always contain a request ID which can be used to identify the request to Clear Street for tracing, and optionally may incl…
6 properties 1 required
InstrumentCashFlowStatement
object
A quarterly cash flow statement for an instrument.
45 properties 6 required
SnapshotSession
object
Session-level pricing metrics for a market data snapshot.
3 properties 3 required
NewsType
string
News item classification.
FiscalPeriodType
string
Fiscal period type for earnings reports
MarketDataSnapshotList
array
InstrumentAllEventsData
object
All-events payload grouped by date.
1 property 1 required
InstrumentEventsData
object
Grouped instrument events by type
5 properties 4 required
DailySummaryList
array
ApiError
object
A direct mapping of tonic::Status, for use in HTTP responses.
3 properties 2 required
InstrumentFundamentals
object
Supplemental fundamentals and company profile data for an instrument.
15 properties
InstrumentAnalystConsensus
object
Aggregated analyst consensus metrics
4 properties 1 required
NewsItemList
array
MarketDataSnapshot
object
Market data snapshot for a single security.
8 properties 2 required
InstrumentEarnings
object
Represents instrument earnings data
8 properties 1 required
NewsItem
object
A single news item and its associated instruments.
9 properties 6 required
InstrumentIncomeStatement
object
A quarterly income statement for an instrument.
37 properties 6 required
InstrumentCashFlowStatementList
array
SnapshotLastTrade
object
Last-trade fields for a market data snapshot. For index instruments this carries the current index level — a computed value, not a trade: price is the level an…
2 properties 2 required
AllEventsEventType
string
Event types supported by the all-events endpoint.
BaseResponse
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

clear-street-instrument-data-api-openapi.yml Raw ↑

Other APIs Clear Street publishes across the network.

Clear Street MCP Server
Clear Street API (Trades and Uploads)
Clear Street Accounts API
Clear Street API version API
Clear Street Calendar API
Clear Street Entities API
Clear Street Holdings API
Clear Street Instruments API
Clear Street Inventories API
Clear Street Locates API
Clear Street Margin API
Clear Street Margin Simulations API
Where this information came from

This is an independent, third-party profile of Clear Street Instrument Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.