# Tradytics API

> A JSON API and MCP server for live and historical options flow, dark pool prints, prices, the options market, research, the scanner and AI trade signals.

- [Overview](https://tradytics.com/docs/index.md): One API for options flow, dark pools and the whole stock market: every options print and dark pool print, dealer positioning, chains and volatility, prices, fundamentals, SEC filings and disclosures, company KPIs, prediction markets and Signals. Included with Tradytics Pro.

## Getting started

- [Quickstart](https://tradytics.com/docs/quickstart.md): Make your first call in a minute.
- [MCP server](https://tradytics.com/docs/mcp.md): Connect Claude, ChatGPT, Cursor or any MCP client to Tradytics. You sign in with your Tradytics Pro account and the app answers from the same data as the API.
- [MCP tools](https://tradytics.com/docs/mcp-tools.md): 30 tools cover every endpoint, one per kind of question. All of them only read.
- [Libraries](https://tradytics.com/docs/libraries.md): Official clients for Python and JavaScript: one method per endpoint, retries on rate limits, paging and streaming built in. No dependencies.
- [API keys](https://tradytics.com/docs/authentication.md): Send your API key in the URL as the apiKey query parameter.
- [Pay per call](https://tradytics.com/docs/pay-per-call.md): Call any endpoint without an API key: pay $0.004 a call in USDC on Base with x402.
- [Rate limits](https://tradytics.com/docs/rate-limits.md): The API is included with Pro. Each key gets 300 calls a minute and 50,000 a day.
- [Errors](https://tradytics.com/docs/errors.md): A failed call answers a 4xx or 5xx status with the same JSON shape every time.
- [Pagination](https://tradytics.com/docs/pagination.md): Long lists come a page at a time, newest first.
- [Time and history](https://tradytics.com/docs/time.md): Every endpoint reads time the same way.
- [Data conventions](https://tradytics.com/docs/conventions.md): What the numbers and fields mean across every endpoint.
- [Support](https://tradytics.com/docs/support.md): Talk to the Tradytics team about your account, billing, API keys, the MCP server, or Tradytics in ChatGPT and Claude.

## Options

- [Options flow](https://tradytics.com/docs/options-flow.md): Every options print of $25K+ as it happens and back to 2025-03-31, with side, sweep or block, opening and outcome, and the flow summed by time, name, strike and contract.
- [Options flow](https://tradytics.com/docs/options-flow/options-flow.md) (GET /options/flow): Prints newest first: the live session by default, one session with date, or a range since 2025-03-31. Pass since to poll the live session, oldest first. Cancelled trades are left out.
- [One print](https://tradytics.com/docs/options-flow/options-flow-id.md) (GET /options/flow/{id}): One print with the session's flow up to it, and what the contract did after: its close the next session and its value at expiry (the latest close until then). outcome is null until the session after the print has closed, or the contract has expired.
- [Flow timeline](https://tradytics.com/docs/options-flow/options-flow-timeline.md) (GET /options/flow/timeline): Net call and put premium, net delta and put/call per interval, oldest first, with the price. Without symbol: every single stock (no ETFs or index products), priced by SPY. Intraday intervals cover one session (default the latest); 1d takes from/to (default 30 days).
- [Flow leaders](https://tradytics.com/docs/options-flow/options-flow-leaders.md) (GET /options/flow/leaders): Single stocks, or their sectors, ranked by net premium for the latest session or date, with premium against their 20-session average.
- [Flow by strike](https://tradytics.com/docs/options-flow/options-flow-strikes.md) (GET /options/flow/strikes): Premium by strike and expiry for one underlying over the latest session, date or a range, busiest first.
- [Unusual contracts](https://tradytics.com/docs/options-flow/options-unusual.md) (GET /options/unusual): Contracts whose session volume ran past their open interest, with volume against their 20-session average, for the latest session or date. Largest premium first.
- [Options contracts](https://tradytics.com/docs/options-contracts.md): Every listed contract with quotes, greeks and IV, the market-wide contract screener, one contract's bars and open interest by strike or expiry.
- [Option chain](https://tradytics.com/docs/options-contracts/options-chain.md) (GET /options/chain): A symbol's standard contracts (100 shares) with quotes, volume, open interest, IV and greeks, live (refreshed every 30 seconds) or any session since 2026-11-06 at its close. Sorted by expiry, strike, calls first.
- [Expirations](https://tradytics.com/docs/options-contracts/options-expirations.md) (GET /options/expirations): Every listed expiry, soonest first, with its contracts, strikes and cycle.
- [Contracts](https://tradytics.com/docs/options-contracts/options-contracts.md) (GET /options/contracts): Contracts of the ~4,000 most traded stocks and ETFs at the latest close (or date's), ranked by volume, premium, IV, open interest or the change in either: the options screener.
- [Contract](https://tradytics.com/docs/options-contracts/options-contracts-contract.md) (GET /options/contracts/{contract}): One contract now: the quote with sizes, the last trade, the session's range and volume, open interest, IV, greeks and the stock's price.
- [Contract bars](https://tradytics.com/docs/options-contracts/options-contracts-contract-bars.md) (GET /options/contracts/{contract}/bars): OHLCV bars with VWAP for one contract, oldest first. Without from: 5 days of 1m, 10 of 5m, 20 of 15m, 60 of 1h, a year of 1d.
- [Open interest](https://tradytics.com/docs/options-contracts/options-open-interest.md) (GET /options/open-interest): Call and put open interest by strike or by expiry with the change since the session before, at the latest close (or date's).
- [Dealer positioning](https://tradytics.com/docs/options-positioning.md): Dealer gamma, delta, vanna and charm by strike or expiry for about 2,500 stocks, ETFs and indices, every 5 minutes of the session, at any moment since 2026-11-06, and 18 months of daily totals.
- [Dealer exposure](https://tradytics.com/docs/options-positioning/options-exposure.md) (GET /options/exposure): The latest run of the dealer model (every 5 minutes of the session) or the one standing at at (since 2026-11-06), by strike or by expiry, with its walls, gamma flip and max pain.
- [Exposure history](https://tradytics.com/docs/options-positioning/options-exposure-history.md) (GET /options/exposure/history): Daily dealer net delta and net gamma against the close, each session of about 18 months, oldest first.
- [Volatility](https://tradytics.com/docs/options-volatility.md): Implied against realized volatility for every optionable stock and ETF: IV rank, term structure, skew, expected moves and a daily history.
- [Volatility](https://tradytics.com/docs/options-volatility/options-volatility.md) (GET /options/volatility): One symbol's 30-day ATM IV against its past year and its realized vol, the ATM term structure, 25-delta skew and the moves options price. Live in regular hours until the close is stored (about 16:25 New York), then that close.
- [Volatility history](https://tradytics.com/docs/options-volatility/options-volatility-history.md) (GET /options/volatility/history): Daily 30-day ATM IV with its rank and percentile, realized vol and the close, oldest first, from November 2025.

## Dark pool

- [Dark pool](https://tradytics.com/docs/darkpool.md): Block prints of 25,000+ shares and $250K+ on and off exchange, live and since 2025-06-09, each ranked against the stock's own year, with price levels and daily totals.
- [Dark pool prints](https://tradytics.com/docs/darkpool/darkpool-prints.md) (GET /darkpool/prints): Prints newest first (or largest): the live session by default (07:00 to 18:00 New York), one session with date, or a range since 2025-06-09. The morning after, each session is final: 04:00 to 20:00, the auctions and ranks, the same ids. Pass since to poll the live session as prints arrive.
- [Dark pool levels](https://tradytics.com/docs/darkpool/darkpool-levels.md) (GET /darkpool/levels): The price levels with the most dark pool block money over the last window sessions to date, biggest first: off-exchange block trades in bins of 0.25% of the last close.
- [Dark pool by day](https://tradytics.com/docs/darkpool/darkpool-daily.md) (GET /darkpool/daily): Session totals newest first: one stock's sessions (default the last year, zeros on a session it traded without blocks), or without symbol one session's names by dark pool notional. Each session ranked against the stock's own year.

## Stocks

- [Stocks](https://tradytics.com/docs/stocks.md): Live quotes, chart bars down to the second, the whole market in one call, technicals, short data and corporate actions for every US stock.
- [Quotes](https://tradytics.com/docs/stocks/stocks-quotes.md) (GET /stocks/quotes): Quotes for up to 100 distinct tickers, or the full market ranked by dollar volume. Refreshes about every 30 seconds. meta.as_of is the snapshot time; price_at is the source minute.
- [Bars](https://tradytics.com/docs/stocks/stocks-bars.md) (GET /stocks/bars): Split-adjusted OHLCV bars with VWAP, oldest first, including the forming bar. Daily and weekly bars go back to 2004 for every US stock; intraday bars cover two years of the ~3,000 most traded symbols and the four major indices, 1-second bars the last 7 days.
- [Market snapshot](https://tradytics.com/docs/stocks/stocks-snapshot.md) (GET /stocks/snapshot): Every listed stock, fund and index at once with its move, volume and size, sorted any way: movers, most active and the heatmap from one call.
- [Technicals](https://tradytics.com/docs/stocks/stocks-technicals.md) (GET /stocks/technicals): A technical rating with the signals, moving averages and oscillators behind it, and monthly seasonality, on daily bars through today.
- [Short interest](https://tradytics.com/docs/stocks/stocks-short-interest.md) (GET /stocks/short-interest): Short interest at every FINRA settlement date, twice a month, newest first.
- [Short volume](https://tradytics.com/docs/stocks/stocks-short-volume.md) (GET /stocks/short-volume): Daily off-exchange short sale volume reported to FINRA, newest first.
- [Dividends and splits](https://tradytics.com/docs/stocks/stocks-corporate-actions.md) (GET /stocks/corporate-actions): Dividends and splits, newest first: one symbol's whole history, or the whole market's within up to 93 days (default a week back to a month ahead).

## Fundamentals

- [Fundamentals](https://tradytics.com/docs/fundamentals.md): Every US filer's income statements, balance sheets and cash flow since 2009, built from its own filings the day they are filed, ratios at the price now or any close, and what analysts expect, report by report.
- [Company profile](https://tradytics.com/docs/fundamentals/fundamentals-profile.md) (GET /fundamentals/profile): The company, its size and its valuation at the price now.
- [Income statement](https://tradytics.com/docs/fundamentals/fundamentals-income-statement.md) (GET /fundamentals/income-statement): Quarterly, annual or trailing-twelve-month income statements from the 10-Qs and 10-Ks, newest first, at the latest filed figures; a renamed ticker keeps its history (META includes its years as FB). Q4 is the year less nine months. A line the filing doesn't show, or shows as zero, is null.
- [Balance sheet](https://tradytics.com/docs/fundamentals/fundamentals-balance-sheet.md) (GET /fundamentals/balance-sheet): Quarterly or annual balance sheets from the 10-Qs and 10-Ks, newest first, at the latest filed figures. A line the filing doesn't show, or shows as zero, is null.
- [Cash flow statement](https://tradytics.com/docs/fundamentals/fundamentals-cash-flow.md) (GET /fundamentals/cash-flow): Quarterly, annual or trailing-twelve-month cash flow statements, newest first: a quarter is the filing's year to date less the quarter before's. A line the filing doesn't show, or shows as zero, is null.
- [Ratios](https://tradytics.com/docs/fundamentals/fundamentals-ratios.md) (GET /fundamentals/ratios): Valuation, margin, return and balance sheet ratios on the trailing twelve months: at the price now, or at each close since 2009 with from and to, on the statements on file that day.
- [Revenue segments](https://tradytics.com/docs/fundamentals/fundamentals-segments.md) (GET /fundamentals/segments): Revenue by product line or by region as reported, newest period first, largest segment first.
- [Earnings](https://tradytics.com/docs/fundamentals/fundamentals-earnings.md) (GET /fundamentals/earnings): Every report with EPS and revenue against the estimates, newest first. The next report comes first, its actuals null.
- [Analyst estimates](https://tradytics.com/docs/fundamentals/fundamentals-estimates.md) (GET /fundamentals/estimates): Consensus for each fiscal period not reported yet, nearest first.
- [Analysts](https://tradytics.com/docs/fundamentals/fundamentals-analysts.md) (GET /fundamentals/analysts): Ratings consensus, price targets and the latest 50 calls by firm.
- [Call transcripts](https://tradytics.com/docs/fundamentals/fundamentals-transcripts.md) (GET /fundamentals/transcripts): Earnings call transcripts: the latest, one quarter, or every quarter of a fiscal year.
- [ETF holdings](https://tradytics.com/docs/fundamentals/fundamentals-etf-holdings.md) (GET /fundamentals/etf-holdings): Everything a fund holds, largest weight first, as its issuer last published.

## Filings

- [Filings](https://tradytics.com/docs/filings.md): Every SEC filing of the last three years and each new one seconds after EDGAR accepts it, with 10-K, 10-Q and 8-K sections as text and full-text search.
- [List filings](https://tradytics.com/docs/filings/filings.md) (GET /filings): Filings newest first, for the whole market or a few companies, by form, 8-K item and date.
- [Search filings](https://tradytics.com/docs/filings/filings-search.md) (GET /filings/search): Full-text search of every filing and exhibit since 2001: the documents that match.
- [Filing](https://tradytics.com/docs/filings/filings-accession.md) (GET /filings/{accession}): One filing with every document and exhibit in it.
- [Filing sections](https://tradytics.com/docs/filings/filings-accession-sections.md) (GET /filings/{accession}/sections): Sections of a 10-K, 10-Q or 8-K as plain text. A section asked for the first time can answer warming_up for a few seconds.

## Disclosures

- [Disclosures](https://tradytics.com/docs/disclosures.md): Insider trades, institutional holdings, activist stakes and Congress trades.
- [Insider trades](https://tradytics.com/docs/disclosures/disclosures-insiders.md) (GET /disclosures/insiders): Every Form 4 transaction, newest filing first: officers, directors and 10% owners buying, selling, exercising and receiving stock. Two years back, new ones within a minute of filing.
- [Institutional holders](https://tradytics.com/docs/disclosures/disclosures-institutions.md) (GET /disclosures/institutions): Every institution that reported a stock on its 13F for a quarter, biggest position first, with what it bought or sold since the quarter before. The last 8 quarters.
- [Institution holdings](https://tradytics.com/docs/disclosures/disclosures-institutions-cik.md) (GET /disclosures/institutions/{cik}): One institution's whole 13F book for a quarter, biggest position first, with the changes from the quarter before.
- [Activist stakes](https://tradytics.com/docs/disclosures/disclosures-activists.md) (GET /disclosures/activists): Schedule 13D (activist) and 13G (passive) filings of holders of 5% or more, newest first. Two years back.
- [Congress trades](https://tradytics.com/docs/disclosures/disclosures-congress.md) (GET /disclosures/congress): Stock trades members of the House and Senate disclosed, newest disclosure first. Three years back.

## KPIs

- [KPIs](https://tradytics.com/docs/kpis.md): The operating numbers that move stocks: deliveries, subscribers, same-store sales, nights booked, store counts, and weekly numbers published on the web. Every value comes with its source and the line it was read from, and each reported value is confirmed by a second, independent read of its filing before it is served.
- [KPIs](https://tradytics.com/docs/kpis/kpis.md) (GET /kpis): One company's KPI values, newest first: each fiscal quarter's numbers from its results release, 10-Q or 10-K, and the weekly numbers tracked for it.
- [KPI definitions](https://tradytics.com/docs/kpis/kpis-definitions.md) (GET /kpis/definitions): The KPIs covered for each company, the periods they span, and whether the company still reports them. A KPI is never removed: one the company stops reporting is stopped, one it redefines is replaced by a new id from that quarter on.

## Market

- [Market](https://tradytics.com/docs/market.md): The US stock market at a glance: whether it's open, the headline indices, breadth, and every sector and theme.
- [Market status](https://tradytics.com/docs/market/market-status.md) (GET /market/status): Whether the market is open now, the next open and close, and the holidays and early closes ahead.
- [Indices](https://tradytics.com/docs/market/market-indices.md) (GET /market/indices): The S&P 500, Nasdaq 100, Russell 2000, Dow Jones Industrial Average and VIX, live in the session.
- [Breadth](https://tradytics.com/docs/market/market-breadth.md) (GET /market/breadth): How many liquid stocks and ADRs ($20M+ traded today, funds left out) are up and down, how today's moves spread, and the equal-weight S&P 500 against the cap-weighted one.
- [Sectors and themes](https://tradytics.com/docs/market/market-sectors.md) (GET /market/sectors): The 11 sectors through their SPDR ETFs, or two dozen investing themes as equal-weight baskets, with returns over six periods and today's best and worst members.

## Calendar and news

- [Calendar](https://tradytics.com/docs/calendar.md): Earnings reports and economic releases, past and ahead.
- [Earnings calendar](https://tradytics.com/docs/calendar/calendar-earnings.md) (GET /calendar/earnings): Reports by date then company size, with estimates and results. Actuals use the same filed figures and verified releases as /fundamentals/earnings. Without symbol, every US listing in the range, past or ahead (default the next 7 days, up to 93 a call); with it, the company's whole history, newest first.
- [Economic calendar](https://tradytics.com/docs/calendar/calendar-economic.md) (GET /calendar/economic): Economic releases and central bank events by time. FMP supplies the readings and estimates. The official BEA schedule fills gaps in upcoming US GDP release dates, with readings and estimates null when unavailable. Default the US, yesterday to a week ahead, up to 93 days a call.
- [News](https://tradytics.com/docs/news.md): Market news with short summaries, tagged by ticker.
- [News](https://tradytics.com/docs/news/news.md) (GET /news): Stories newest first, all of them or one symbol's. Default the last 30 days.

## Screener

- [Screener](https://tradytics.com/docs/screener.md): Every US stock and fund on 99 fields across price, technicals, fundamentals, options flow, dark pool and events, with 117 labels, rebuilt after each close.
- [Screen stocks](https://tradytics.com/docs/screener/screener-stocks.md) (GET /screener/stocks): Filter on any numeric field with min_<field> and max_<field> (min_relative_volume=2&max_rsi=30), require labels and sort by any field; or pass symbol for those rows. Metadata separates the scan build time (scan_as_of) from the quote snapshot time (quote_as_of).
- [Screener fields](https://tradytics.com/docs/screener/screener-fields.md) (GET /screener/fields): Every field with its group and type, and every label with its group and lean.

## Signals

- [Signals](https://tradytics.com/docs/signals.md): Live orders matching one of seven flow patterns tested on years of options flow, each the contract the flow bought, priced at the ask and marked every five minutes to expiry.
- [List signals](https://tradytics.com/docs/signals/signals.md) (GET /signals): Signals newest first, today's live.
- [Signal](https://tradytics.com/docs/signals/signals-id.md) (GET /signals/{id}): One signal with the numbers its pattern read, the prints behind it and every mark.
- [Signal performance](https://tradytics.com/docs/signals/signals-performance.md) (GET /signals/performance): Each pattern's record from every signal's latest mark or settlement, losers included, over the last 7, 30 and 90 days and all time.

## Insights

- [Insights](https://tradytics.com/docs/insights.md): What the market did and why, and why each stock is moving.
- [Market digest](https://tradytics.com/docs/insights/insights-market.md) (GET /insights/market): The market in a headline, a summary and three stories, with the week's events ahead. Rewritten every 30 minutes in the session.
- [Why it's moving](https://tradytics.com/docs/insights/insights-movers.md) (GET /insights/movers): Each stock's latest story behind its move, newest first: the 100 largest companies and the most viewed, rewritten through the day.

## Probabilities

- [Probabilities](https://tradytics.com/docs/probabilities.md): Every live finance question on Kalshi and Polymarket, each outcome's chance through time, the S&P 500 outlook and the settled archive since 2021.
- [List questions](https://tradytics.com/docs/probabilities/probabilities.md) (GET /probabilities): Every live question with a tight book and trades in the last day, with its leading outcomes.
- [Question](https://tradytics.com/docs/probabilities/probabilities-id.md) (GET /probabilities/{id}): One open question with every outcome, and for an earnings question the stock's past reports and moves.
- [Outcome history](https://tradytics.com/docs/probabilities/probabilities-id-history.md) (GET /probabilities/{id}/history): One outcome's chance through time, live or settled: the last trade in each hour or day.
- [S&P 500 outlook](https://tradytics.com/docs/probabilities/probabilities-outlook.md) (GET /probabilities/outlook): Where Kalshi and Polymarket put the S&P 500 at each date they price, from the next close to year end, and the last 30 sessions' 10 AM calls on the S&P 500 and Nasdaq-100 against the close.
- [Settled markets](https://tradytics.com/docs/probabilities/probabilities-settled.md) (GET /probabilities/settled): Every finance market Kalshi has settled since June 2021, and Polymarket's, the latest to close first. Default the last 30 days unless series is set.

## AI Fund

- [AI Fund](https://tradytics.com/docs/fund.md): The Tradytics AI Fund, an options book run by AI: its exposure, positions, trades and the portfolio manager's posts, sized as fractions of the fund.
- [The fund](https://tradytics.com/docs/fund/fund.md) (GET /fund): Exposure, open positions and the latest 20 posts and letters.
- [Fund trades](https://tradytics.com/docs/fund/fund-trades.md) (GET /fund/trades): Every trade, open and closed, newest first.

## Symbols

- [Symbols](https://tradytics.com/docs/symbols.md): Every US stock, fund and index Tradytics tracks, and each one's profile.
- [List symbols](https://tradytics.com/docs/symbols/symbols.md) (GET /symbols): The ~6,000 symbols Tradytics tracks, most traded first. Search by ticker or name with q.
- [Symbol](https://tradytics.com/docs/symbols/symbols-symbol.md) (GET /symbols/{symbol}): One symbol: its name, kind, sector, industry, size and live quote.

## Your account

- [Your account](https://tradytics.com/docs/account.md): Your own linked portfolio, backtests, dashboards and watchlists; a key reads only its own account, and another account's id answers 404.
- [Your portfolio](https://tradytics.com/docs/account/account-portfolio.md) (GET /account/portfolio): Your linked brokerage accounts, read only: holdings, options and recent orders, in each account's currency.
- [Your trades](https://tradytics.com/docs/account/account-portfolio-trades.md) (GET /account/portfolio/trades): A year of closed round trips, newest first, with dividends and fees per account.
- [Your factors](https://tradytics.com/docs/account/account-portfolio-factors.md) (GET /account/portfolio/factors): Your book's risk by source, beta, value at risk and tracking error, each holding's share, crash replays, and returns split into market, sectors, styles and stock picking. 404 not_connected before a brokerage is linked.
- [Your backtests](https://tradytics.com/docs/account/account-backtests.md) (GET /account/backtests): Your backtests, the latest first.
- [A backtest](https://tradytics.com/docs/account/account-backtests-id.md) (GET /account/backtests/{id}): One backtest: the conversation and every run it made.
- [Your dashboards](https://tradytics.com/docs/account/account-dashboards.md) (GET /account/dashboards): Your dashboards.
- [A dashboard](https://tradytics.com/docs/account/account-dashboards-id.md) (GET /account/dashboards/{id}): One dashboard's layout on a 12-column grid.
- [Your watchlists](https://tradytics.com/docs/account/account-watchlists.md) (GET /account/watchlists): Your watchlists, the default first, each with its symbols in the order added.

## Integrations

- [Integrations](https://tradytics.com/docs/integrations.md): Tradytics in agent directories, skill registries and API tools.