All APIs & Data ServicesBuilt for ChartDeck

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.

Manage access How to use it

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

  1. 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.

  2. 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.

  3. 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

GET/v1/capabilities

Check the effective access tier, permitted sources, and rate plan for your token.

GET/v1/news/items

Retrieve news and filings with ticker, source, date, and document-type filters plus cursor pagination.

POST/v1/news/query

Query news for up to 100 symbols in one request, grouped in the order you supply.

GET/v1/events/items

Retrieve earnings, dividend, and split events for the requested symbols.

POST/v1/events/query

Query events for multiple symbols with a shared refresh mode.

GET/v1/news/stream

Receive 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.

Available

Company descriptions

Show a short description of what a company does, drawn from the business section of its annual report. The description includes a source link and reporting dates, and earlier versions remain available when a newer report is processed.

The index baseline covers 3,001 stock tickers across 2,980 companies using dated S&P 500 and Nasdaq-100 snapshots plus Russell 1000 and Russell 2000 coverage from filtered IWB and IWM stock holdings, as of October 14–15, 2026. ETF holdings can differ from official index membership. Monthly exchange-directory scans expand coverage to other verified US-listed common and ordinary stocks. Coverage is limited to companies already imported into the catalog; description availability depends on a successful filing extraction; newly added companies can be pending.

Example: look up BrightSpring's description

# Use a valid Diszy bearer token with sec-edgar source access.
curl --fail-with-body \
  -H "Authorization: Bearer $DISZY_ACCESS_TOKEN" \
  'https://news-api.diszy.com/v1/companies?symbol=BTSG&mic=XNAS'

Use the same Stocks API base URL and a valid Diszy bearer token that permits sec-edgar. Read the description text from data[0].description.summary on the company search response. Include the venue MIC, such as XNAS for Nasdaq, to distinguish listings that share a ticker. Company-detail responses expose the same text at data.description.summary.

Company descriptions are included in free SEC access. Supported ChartDeck clients can use the existing anonymous token flow without a paid subscription. A missing bearer token returns 401; a token without SEC access returns 403. Anonymous access is limited to 30 HTTP requests per minute per token, with an additional aggregate limit. Check /v1/capabilities for your current limits.

Company endpoints

GET/v1/companies?symbol=BTSG&mic=XNAS

Find the company for a ticker and venue, including its current description and source dates.

GET/v1/companies/{companyId}

Read a company by its stable UUID, including listings, description, and refresh status.

GET/v1/companies/{companyId}/descriptions

Read earlier description versions, with limit and offset pagination.

Alongside summary, the description returns sourceUrl, filedOn, reportOn, generatedAt, and generatorVersion. The first generator selects complete source sentences from supported 10-K and 20-F business sections. Before the first annual report, it can use a supported 424B4, S-1 or F-1 prospectus Business section, with the actual filing form and date and a null reportOn. It preserves the filing's original wording.

Monthly discovery compares US exchange directories with SEC issuer mappings. Verified new companies enter the description queue; ticker and venue changes follow the same SEC CIK so company IDs and earlier descriptions stay available. Unresolved identities wait for review. Scans run at the start of each month and retry source failures; dated index membership is maintained separately.

An empty data array means no tracked company matched the search. A company's description can be null before its first successful extraction. Check refresh for the last check, next check, and failure status. Refreshes run in the background approximately hourly; a failed refresh preserves the previous description. Requests read stored data and do not trigger a new filing download. A deployed API with the catalog disabled returns 503 feature_disabled.

Requests read descriptions stored in PostgreSQL; there is no separate response cache or per-request generation. TOWN, NBN, HIFS, and FRBA file with the FDIC and currently have listings without descriptions or refresh targets while an FDIC adapter is pending.

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.

Manage access Discuss an integration