Stocks API
The stories and events behind a stock.
The Diszy Stocks API brings company news, public SEC filings, and company events together by ticker. It powers stock context in ChartDeck and provides structured data for news panels, watchlists, and event calendars.
What you can build with it
Company news
Follow stock-specific headlines with publisher details, source summaries when available, and links to the original stories.
SEC filings
Find public SEC EDGAR filing metadata by ticker and open the original filing for the full company disclosure.
Company events
Bring earnings dates, dividends, and stock splits into a calendar or display them alongside the relevant chart.
News responses provide metadata and available source summaries. Full articles and filings open at the original source. Coverage and freshness depend on each data provider.
Get started in ChartDeck
Choose your access
Supported ChartDeck versions can access public SEC filings without a paid subscription. Additional news and calendar sources depend on your Diszy access and the sources enabled for it.
Connect from ChartDeck
In a ChartDeck version with Diszy News enabled, start the Diszy connection from the app. Sign in and approve access in your browser, then return to ChartDeck. You can manage your subscription, installations, and app sessions in the Diszy access portal.
Open a stock
Choose a ticker to load its news and company events. Read the available summaries, open original sources, and use event dates to put the chart in context.
For developers
Make your first request
Use a valid Diszy bearer token from an enabled app session or a provisioned installation. Pass it in the Authorization header and check your capabilities before requesting a source. The examples below are for a terminal or backend integration; keep credentials out of browser code and URLs.
Example: SEC filings for one stock
# Set DISZY_ACCESS_TOKEN to your valid Diszy bearer token.
# Check which sources your access permits.
curl --fail-with-body \
-H "Authorization: Bearer $DISZY_ACCESS_TOKEN" \
'https://news-api.diszy.com/v1/capabilities'
# Request the five most recent SEC items for AAPL.
curl --fail-with-body \
-H "Authorization: Bearer $DISZY_ACCESS_TOKEN" \
'https://news-api.diszy.com/v1/news/items?symbols=AAPL&sources=sec-edgar&sort=recent&limit=5'Core endpoints
/v1/capabilitiesCheck the effective access tier, permitted sources, and rate plan for your token.
/v1/news/itemsRetrieve news and filings with ticker, source, date, and document-type filters plus cursor pagination.
/v1/news/queryQuery news for up to 100 symbols in one request, grouped in the order you supply.
/v1/events/itemsRetrieve earnings, dividend, and split events for the requested symbols.
/v1/events/queryQuery events for multiple symbols with a shared refresh mode.
/v1/news/streamReceive news updates through an authenticated Server-Sent Events stream.
Use if_stale for routine refreshes and reserve force for explicit user refreshes. News batches can return cached items while updates arrive through the stream. Honor Retry-After on rate-limit responses and renew expired access tokens before retrying.
Connect your stock research
Manage an existing Diszy connection in the access portal, or talk to us about using the API in your own application.