TradingData

Two to eight macro series on one date axis: unemployment or inflation across countries, government yields, GDP growth, CPI against the Fed funds rate. Mixed frequencies are aggregated at the source to the coarsest unless one is given; optional transformation and rebasing to 100. Returns metadata and a summary per series plus the aligned table. Find ids with search_macro_series.

Side-by-side comparison of 2 to 10 stocks or ETFs on any exchange: price versus the 52-week high, market cap, valuation, growth (with 3/5-year CAGRs for SEC registrants), margins, leverage, ROE, ROIC, returns from one week to five years and analyst consensus for US names, with a 'leaders' map per metric. Trailing twelve months in each listing's currency.

Sell-side consensus for a US-listed stock: mean rating and analyst count, price targets (low, average, high) with buy/hold/sell counts and six months of rating history, consensus EPS by quarter and fiscal year with revisions, reported EPS versus consensus with surprise percent, and estimate momentum versus a week and a month ago.

Who owns the company: 5%+ holders from their latest Schedule 13D/13G (holder, percent, shares, form and date; 13D marks active intent, 13G a passive stake), plus insiders' latest holdings from Form 4. Holders amended to 0% are listed as exited. For institutional 13F positions use get_institutional_holders.

Government bond yields in one call: the full US Treasury par curve with 1-day to 1-year moves, shape and 2s10s/3m10s/5s30s spreads; TIPS real yields and breakevens; 10-year (and 2-year where quoted) yields for 18 countries with spreads to Bunds and Treasuries; quoted curves for the UK, Germany, Japan, France, Italy and Spain; optional daily US history. Yields in percent, changes in basis points.

Front-month futures prices and daily change for energy (WTI, Brent, natural gas, gasoline, heating oil), metals (gold, silver, platinum, palladium, copper, aluminum), agriculture (corn, wheat, soybeans, coffee, sugar, cocoa, cotton, orange juice, lumber) and livestock. For history of one commodity use get_ohlcv with its futures code, e.g. GC=F.

SEC registrant profile for a US-listed company with a trailing-twelve-month snapshot (revenue, margins, EBITDA, net income, EPS, cash flows, free cash flow, cash, debt, net debt, enterprise value, EV multiples, ROIC, 3/5-year growth, shares, market cap, P/E, P/S, P/B, FCF yield) and its five most recent filings. For consensus use get_analyst_estimates; for segments get_segment_financials.

Commitments of Traders (legacy, futures only) for a market: speculators' long, short and net positions, net as percent of open interest, weekly change, commercials' and small traders' net, and where the current net sits within the window (percentile, max, min).

Profile of one crypto asset: description, categories, links, price, 24h/7d/30d/1y change, market cap, FDV, volume, supply and all-time high/low. Accepts a ticker ('SOL'), a name ('solana') or an asset id.

Perpetual-swap snapshot for a coin (BTC, ETH, SOL…): mark and index price with basis, 24h volume, funding rate (last, annualized, 7- and 30-day averages, 8-hour history), open interest with 1/7/30-day change and history, and long/short positioning. Pair with get_crypto_options for the full derivatives picture.

Ranked table of crypto assets by market cap with price, 1h/24h/7d/30d change, market cap, FDV, 24h volume, supply and all-time high. Filter by asset ids or a category slug (e.g. 'layer-1', 'meme-token', 'decentralized-finance-defi', 'stablecoins', 'artificial-intelligence').

Options market overview for BTC or ETH (also other listed coins): index price, 30-day volatility index with week- and month-ago values, total open interest and 24h volume by calls and puts, and per expiry: ATM implied volatility, the one-sigma move it implies, 10%-OTM put/call IV skew, put/call open-interest ratio, max pain and the strikes with most open interest.

DeFi data. view='chains': TVL by chain. 'protocols': TVL, 1d/7d change, market cap to TVL (filter by query, category such as 'Lending', 'Dexs', 'Liquid Staking', or chain). 'stablecoins': supply and 1d/7d/30d changes. 'dexs': 24h/7d volumes by DEX. 'fees' or 'revenue': 24h/7d/30d by protocol. 'yields': pools with APY and TVL (filters stablecoin_only, chain, symbol, project; sort apy or tvl).

Dividend profile and history for a US-listed stock or ETF: last ex-dividend and payment dates, cadence, estimated next ex-date, yield, annualized dividend, payout ratio, trailing cash per share and past distributions. source is 'provider' (feed with ex-dates) or 'sec_filings' (declared per share by fiscal period) when the feed has nothing for the stock.

Who reports when. Give a date range (up to 14 days) for every US company scheduled to report, with timing (before open / after close), fiscal quarter, consensus EPS and estimate count; or give symbols to find their next scheduled reports in the coming weeks.

Structured reading of the latest earnings release: the headline results table (current, prior year, change), the operating KPIs the company highlights (users, deliveries, subscribers, capex…) with year-over-year change, non-GAAP measures and parsed guidance (metric, period, range). Heuristic extraction: every item keeps its source sentence for verification.

The latest earnings press release as plain text, captured from newswires within seconds of publication and from SEC filings (8-K Exhibit 99.1; Form 6-K for foreign issuers): headline numbers, the KPIs the company reports (users, ARPU, deliveries, segments), guidance and commentary. Returns highlights plus paged full text; follow nextOffset. Non-GAAP KPIs live here, not in XBRL.

Everything a US-registered ETF or mutual fund holds: report date, assets, breakdowns by asset category, country and issuer type, concentration and the largest positions with weight, value and identifiers. SPDR funds (SPY, DIA, MDY, FEZ, sector funds) use the issuer's daily portfolio; others the latest SEC portfolio report (quarterly, up to 60 days' lag). Commodity trusts (GLD) are not covered.

Text of specific items of a company's latest 10-K or 10-Q, several in one call (for example risk factors and MD&A), trimmed to max_chars each, plus the items detected in the document. For other filings or to page through a long item use read_sec_filing.

Analyst metrics per fiscal period (annual or quarterly) from SEC XBRL filings, for US and foreign issuers: revenue and growth, margins, SG&A split, net income, EPS, cash flows, free cash flow, R&D, SBC, D&A, dividends, buybacks, shares, cash, debt and net debt, equity, ROE, ROA, ROIC, plus 3- and 5-year CAGRs; quarterly rows add trailing-twelve-month figures. In the reporting currency.

Forty-plus trailing-twelve-month ratios for one company from its SEC filings and current price: valuation (P/E, PEG, EV/EBITDA, FCF yield…), profitability (margins, ROE, ROA, ROIC), efficiency (DSO, DIO, DPO, cash conversion cycle), liquidity, leverage, per-share figures and growth (YoY and 3/5-year CAGRs), plus the GICS-style sector. US and foreign SEC filers; reporting currency.

Income statement, balance sheet or cash flow statement from SEC XBRL filings, annual or quarterly, as metric rows aligned to period columns, most recent first. Values in USD; shares and EPS as reported. Cash-flow quarters are differenced from year-to-date totals and Q4 derived from the annual report (marked derived). Free cash flow = operating cash flow − capex.

Constituents and weights of a stock index from the fund that tracks it: daily issuer portfolios for the S&P 500, Dow, S&P MidCap 400, Euro Stoxx 50 and S&P sectors; latest SEC reports for the Nasdaq-100, Russell, S&P 600 and MSCI; the closest country fund for FTSE 100, DAX, CAC 40, IBEX 35, Nikkei 225 and Hang Seng (marked proxy). Returns weights, concentration, a breakdown and the freshness.

Recent insider trades for a company parsed from Form 4 filings: owner, role, transaction type (open-market purchase/sale, grant, option exercise, tax withholding, gift), shares, price, value and holdings after the trade. Open-market purchases (code P) and sales (code S) are the signal; grants and withholding are routine.

Institutional ownership from 13F filings for a US-listed stock: percent of the listed share class held by institutions, number of holders, shares held, how many increased, decreased, opened or closed positions last quarter, and the largest holders with shares, quarterly change and value. Dual-class companies: counts cover the listed class only.

Scheduled economic data releases over the coming days (or any window): CPI, payrolls, GDP, PCE, retail sales, FOMC decisions, jobless claims, JOLTS, industrial production, housing, durable goods, consumer sentiment, trade, Fed balance sheet and more, with the date and what each release covers. Set major_only=false to list every release in the database's calendar (hundreds).

One economic release in full: its most-followed series with latest print, previous, change, year over year and last update, plus the last and next publication dates. Accepts the release name, an alias (CPI, payrolls, GDP, PCE, retail sales, PPI, JOLTS, claims, FOMC, housing starts…) or the id from get_macro_calendar.

How a macro series has been revised since first publication: for each recent period the first print, every revision with its date and the current value, plus the period change as first reported versus now (the headline payrolls revision; GDP's advance, second and third estimates) and a count of upward and downward revisions. Works for any series with a publication history.

Observations, metadata and a latest/previous/year-ago summary for any of 800,000+ US and international macro series (CPI, GDP, rates, employment, money, trade, housing), with optional source-side transformations (change, % change, year over year, annualized) and frequency aggregation. Find ids with search_macro_series; values are as published.

The macro picture in one call: policy and market rates, inflation, growth and activity, labour, money and credit, market gauges, inflation expectations and recession risk. Each indicator carries its latest print with date, the previous print, the year-ago value and the change.

What macro data came out over the last days and what it showed: each release (CPI, payrolls, GDP, PCE, retail sales, claims, JOLTS, housing…) with its headline series (latest, previous, change, year over year), newest first, followed by the next scheduled releases. major_only=false includes every release in the calendar.

One-call briefing of global markets: major equity indices, US Treasury yields, dollar index and main FX pairs, key commodities, and large-cap crypto with total crypto market cap, BTC dominance and the Fear & Greed index. Call this first for 'how are markets doing' questions, then drill down with other tools.

Recent headlines with links. Give symbol for company/asset news (e.g. 'AAPL', 'BTC-USD') or query for free-text topics (e.g. 'Fed rate decision', 'OPEC output'). Returns title, short summary, publisher, publish time and URL.

Historical candles for one symbol as compact columns [time, open, high, low, close, volume] plus summary statistics (period return, high/low, average volume, annualized volatility, max drawdown). Set summary_only=true when you only need the statistics. Intraday intervals (1m–1h) are limited to recent ranges (1m: 7 days, 5m–30m: 60 days, 1h: 2 years).

Daily on-chain and market metrics for major assets (BTC, ETH, SOL, XRP, LTC, ADA, DOGE, LINK, USDT, USDC…): price, market cap, MVRV, active addresses, transactions, transfers, hash rate, fees, issuance and supply. Returns the change over the window plus a compact daily table; omit metrics for a sensible default set.

Option chain for a US stock, ETF or index (SPX, NDX, RUT, VIX), delayed 15 minutes: strikes near spot with bid, ask, last, implied volatility, greeks, open interest and volume, plus per-expiry max pain, expected move, put/call ratios and totals. Defaults to the nearest 3 expirations within 10% of spot; narrow with expiration, type or strike_range_pct to save tokens.

On-chain oracle price feeds for a symbol, read live on Ethereum, Arbitrum, Base, Optimism and BNB Chain, with price, last update, staleness and heartbeat. Covers US equities and ETFs, crypto, commodities (XAU, XAG, WTI, BRENT) and FX. Shows what DeFi contracts price an asset at, and gives equity prices outside exchange hours via 24/5 feeds.

Latest price, change, day range, volume and 52-week range for up to 50 symbols in one call across stocks, ETFs, indices, crypto, commodities and forex, US and international. Symbols: AAPL, SPY, ^GSPC, BTC, gold or GC=F, EURUSD; international listings take an exchange suffix (SAP.DE, ASML.AS, MC.PA, SAN.MC, VOD.L, NESN.SW, 7203.T, 0700.HK). Prefer one batched call over many.

One indicator for every US state and DC in a single call, ranked, with the change from a year earlier or the previous period and the national figure where one exists: unemployment, employment, house prices, real GDP, income, population, building permits, homeownership, or any state-level series id used as the template of its group.

Recent SEC filings for a company with form type, filing date, period, description, 8-K item codes with their meaning, and direct URLs. Filter by form (10-K, 10-Q, 8-K, 4, 13F-HR, S-1, DEF 14A, SC 13D...). Pass a document URL to read_sec_filing to read its text.

Revenue, operating income and other figures by reportable segment from the inline XBRL of the latest 10-K or 10-Q (Meta's Family of Apps versus Reality Labs, Amazon's AWS…), with breakdowns inside a segment when tagged. Periods are those of that filing. Companies that disclose segments only in text return no rows; use read_sec_filing for the MD&A.

Consolidated short interest for a US-listed stock or ETF, published twice a month: shares short, change versus the prior report, days to cover, average daily volume, the year-ago level and recent history. Divide by sharesOutstanding from get_company_profile for percent of shares.

On-chain markets for a tokenized US stock or ETF: the Solana xStock with its DEX price, 24h change, liquidity, holders, market cap and premium versus the underlying share price, plus the deepest DEX pairs on any chain including Ondo tokens on Ethereum. Returns the issuer's reference stock price when available.

Plain text of a filing document (10-K, 10-Q, 8-K, proxy, S-1, exhibits) in pages: give the document url from get_sec_filings, or symbol plus accession. For a 10-K or 10-Q a section can be requested by item number. Use offset to continue when has_more is true.

Screen stocks by numeric filters (size, valuation, growth, margins, returns, performance, volatility), GICS sector, industry and market, sorted by any metric. Universes: us, europe, uk, asia, global. Returns up to 100 matches with price, market cap, P/E, revenue growth, net margin, dividend yield, YTD return, the metrics used and each company's GICS-style sector.

Find macro and economic series by description across 800,000+ US and international series (statistics, central-bank rates, prices, employment, trade, housing, money, markets), most popular first, with id, title, units, frequency, seasonal adjustment and coverage. Then call get_macro_series with the id.

Full-text search across all SEC filings since 2001. Use quotes for exact phrases. Filter by form types, date range and entity name. Returns entity, form, filing date and document URL for read_sec_filing. Note: SEC may block this endpoint from some server regions.

Find the ticker for a company, ETF, index, crypto asset, commodity or currency pair, on US and international exchanges (European and Asian listings come back with their exchange suffix, e.g. NESN.SW, SAP.DE). Returns symbol, name, asset class and exchange. Use when you are unsure of the exact symbol; otherwise call get_quotes directly.