DataPorium

Find a company's tickers across exchanges (main ticker, all listed symbols, CIK). Use this first when you only know a company name. Give symbol OR company_name (exact name, e.g. 'Apple Inc.').

Company profile and fundamentals: sector, industry, description, address, employees, market cap, valuation ratios, dividends, analyst targets and more (also used by the stock screener).

Industry and sector classification of a company (revenue-based sector/industry, NAICS sector, SIC category). Without a company it gives the official US industry code list (NAICS, 2 to 6 digits) with the parent/child tree: industry_code for one code (e.g. '522110', '52' or '31-33') with its parent, path and children; industry_query to search titles (e.g. 'banking'). Code list filters: v

Logo image URL of a company.

Price history (open, high, low, close, volume) plus dividends of a stock, ETF or index. interval '1d' = daily bars (full history available), '5m' = 5-minute bars of about the last month. points = how many of the newest bars to return (default 250, about one trading year of daily bars; up to about 500 fit in one answer). ETFs and indexes work like stocks, e.g. SPY, VOO, QQQ, DIA, IWM, V

Commodity futures prices, e.g. GC=F gold, SI=F silver, CL=F crude oil, NG=F natural gas, ZC=F corn. interval '1d' or '5m'; points = how many of the newest bars to return (default 250). US agriculture (official statistics, added 10/09/2026), with agriculture instead of interval: "commodities": corn, soybeans, wheat, cotton, rice, sorghum, barley, oats, hay, peanuts, sugar_beets, potatoe

Currency exchange rates. currency_conversion like 'USD-EUR'. interval picks the bar size (5m and 1h cover recent days, 1d/1w/1mo cover years).

Financial statements (income statement, balance sheet, cash flow). summary=True returns the compact summary version with the key lines. Filter by fiscal_year (e.g. 2025), fiscal_qtr (e.g. Q2) or fiscal_year_qtr (e.g. 2025Q2); period_type e.g. annual or quarterly. Each period has data_status: "final", or "temporary" for a quarter the company has just reported that is shown early with on

Revenue by business segment, product and geography, from company filings. period="annual" (default): yearly breakdown. period="quarter": revenue per fiscal quarter (needs symbol) by perspective: segment, product, region, country, end_market, channel, customer or subsegment (comma-separated; default all), or perspective="views" to list which views the company has and how many quarters e

SEC filings of a company (10-K, 10-Q, 8-K, ...) with links. form_type filters by form.

Earnings call transcripts. Filter by fiscal_year and fiscal_qtr (e.g. Q3) to get one call; transcripts are long.

Investor presentations (slide decks with links) or press releases of a company.

Recent news articles about one company or crypto coin (full text, sentiment, tags). ticker e.g. AAPL or BTC-USD.

Latest market-wide news by topic (general, stock, forex, crypto).

Market calendars: 'earnings_splits' (earnings dates and stock splits, filter by symbol), 'ipo' (upcoming and recent IPOs), 'economic' (economic events like CPI or Fed decisions, filter by event_name/country).

Stock exchange trading hours or holidays. exchange e.g. NYSE, NASDAQ, LSE.

Today's biggest stock gainers, losers or most active stocks.

Daily performance or P/E history of market sectors or industries (e.g. sector 'Technology', exchange 'NASDAQ').

Insider trading: recent 'transactions', insiders' 'holdings_summary', or full 'transaction_history'.

Institutional ownership: 'major' holders, 'quarterly' 13F holdings (filters year, qtr, period), 'quarterly_summary', ownership 'by_type', share 'class', and holders by country 'geo'.

Option chain (calls and puts with strikes, expirations, prices, volume, open interest) for a stock.

Mergers, acquisitions and investments. 'deals' = full deal records for a company (symbol/company_name), 'summary' = shorter records, 'flat' = one row per deal with filters like ticker_buyer, ticker_target, txn_stage, date_announced, 'reports' = aggregated counts by level/level_values, 'filters' = searchable deal list.

A company's social media and employer data: X (Twitter) profile/posts/follower history, LinkedIn profile/posts/followers and employees, Glassdoor profile and ratings.

US economic data. economic_metrics is either a time series name: GDP, real_GDP, real_GDP_Per_Capita, nominal_Potential_GDP, CPI, inflation, inflation_Rate, federal_Funds, unemployment_Rate, total_Non_farm_Payroll, initial_Claims, retail_Sales, consumer_Sentiment, durable_Goods, industrial_Production_Total_Index, new_Privately_Owned_HousingUnits_Started_Total_Units, total_Vehicle_Sales,

US energy data from official US government sources. category e.g. petroleum, natural-gas, electricity, coal, co2-emissions, total-energy; location e.g. a state code (TX); period e.g. 2024; period_type annual/monthly. category "gas_prices" gives weekly retail pump prices (US dollars per gallon, taxes included) for the US, its fuel regions, 9 states and 10 cities: dataset = product (regu

Healthcare market data: drug/brand revenue by quarter (brand_revenue, filter symbol), company revenue by healthcare industry, market size by country/region, company market share, industry market size and therapy-area market size. industry values: Pharmaceutical, Medical Device, Diagnostic Life Science, Consumer Healthcare, Health Insurance, Healthcare, Distributor, Veterinary, and othe

Short interest of US stocks and ETFs: the shares sold short and not yet bought back, reported twice a month (settlement dates around the 15th and the month end, published about a week later), history from 2017. view "history" (default): one or more symbols (e.g. "GME" or "AAPL,TSLA"), newest first: short_interest, previous_short_interest, change_shares, change_pct, avg_daily_volume, da

Find US homes in a place: give zips, or city (+ state), or county (+ state), or a state. With no location it searches the whole US using a fixed sample, and the counts are approximate (marked approximate in the answer). status: for_sale (default), pending, rent, sold (last 12 months) or off_market. Returns total_matches, a summary of ALL matches (count, median price, median price p

Everything about one US home, by property_id (from search_properties) or by address in any spelling (e.g. "110 Coastal Garden, Irvine CA" or "125 Shell"; ZIP, city and state are optional). Returns the address and location, status, price, estimate, HOA, beds, baths, sqft, lot, year built, description, photos, the listing facts (real listed date, days on market, relisted and when, the wh

Full details of ONE US area in one call: the housing market, property tax, crime, demographics, climate and environmental risk, air quality and the neighborhood profile (schools, amenities, walkability, noise). Name the area with zip, or city + state, or county + state, or metro (e.g. 'Los Angeles, CA'), or just state; a state can be 'CA' or 'California'. Pick the parts with include: m

Stock trades reported by members of the US Congress in their official financial disclosure filings: who traded, party, chamber, trade and filing dates, buy or sell, amount range. Data is delayed by law (filed up to 45 days after the trade). view "trades" (default): the trades, newest first; filter by symbol (e.g. NVDA, or several: "AAPL,MSFT"), member_name (part of a name, e.g. "Pe

US election results with margins, swing, turnout and partisan lean. Coverage: president and US Senate by state for every election 1976 to 2024, US House by district 1976 to 2024 and county results of the presidential race 2000 to 2024; county, city or town, congressional district and precinct results, governors, other statewide offices, state legislature seats and statewide ballot meas

US federal government business of listed companies: federal contracts they win and the lobbying they pay for (official US government data). Contract totals include the units a company owns today, for all years (also years before it owned them); group_by "unit" with a symbol lists those units and their share. view "contract_totals" (default): contract obligations in US dollars (contract

US patents granted to listed companies since 2015 (official US government data), listed under the company that owned the patent when it was granted; and US trademark (brand) filings per company, year and class since 2000. view "totals" (default): patent counts, group_by year (grant year, default with a symbol), section (technology section A to H or Y, plus design patents), cpc_class (t

US healthcare providers, hospitals and health systems from official US government data, linked by keys (NPI for providers, CCN for hospitals, PAC ID for group practices, a system ID for health systems). kind "hospitals" (default): every active Medicare hospital with type, ownership, beds, star rating (1 to 5), health system, listed owner (ticker) and the latest yearly financials; filte

The full profile of ONE healthcare entity, with every mapped link (all by keys, each with match_method and confidence). Give exactly one of: npi: a provider (10 digits): registry record with all specialties and the practice address, Medicare enrollment (specialty, medical school, graduation year, telehealth), group practices with their health system, and hospital affiliations; for

US banks and credit unions (official public data): every institution with its quarterly assets, deposits, loans, equity, profit, return on assets and equity and capital ratio (banks since 1984, credit unions since 2002), branches with deposits (banks, June 30 each year since 1994), and bank failures since 1934. Money in US dollars, ratios in percent. Ids: "b" + number for banks (b628),

Recalls of vehicles and consumer products, vehicle crash test ratings, vehicle owner complaints, trucking carrier safety, and workplace safety, environmental compliance and greenhouse gas emissions of facilities and listed companies (official public data). Vehicle recalls since 1966 (cars, trucks, motorcycles, RVs, and also tires, child car seats and vehicle equipment), consumer produc

Yearly pay that US employers offered in certified work-visa filings (official public data, summarized): H-1B (kind h1b, default), E-3 (e3) and PERM green card filings (perm), by fiscal year (October to September) since 2020, per employer, job group (official occupation code, e.g. 15-1252 Software Developers) and worksite city, metro area or state: filings, workers, median, 25th and 75t

Weekly futures positions by type of trader in US futures markets (official public data, futures only, as of each Tuesday, published the Friday after; since 1986): long, short and net (long - short) contracts per trader category, as a share of open interest, and the change from the week before. Reports: legacy (every market: commercial = hedgers, noncommercial = large speculators, nonre

US airline on-time performance and passenger traffic by month (official public data): on-time %, delays 15+ minutes, cancellations, diversions, average arrival delay and delay causes (since 2010, scheduled domestic flights of the large US airlines and their regional partners, counted at the departure airport), and passengers, seats, departures and load factor per airline, airport and n

Fields you can filter and rank on in screen_stocks (dataset "stocks") and search_housing_areas (dataset "areas"), with unit, description and typical range (10th, 50th, 90th percentile). Call this before screening to choose realistic thresholds. For areas pass the level you will search (ranges differ between states, cities and ZIPs).

START HERE for broad stock questions (no specific company named). Ranks ~45,000 companies in one call. filters: {"field": [min, max]} using fields from describe_screen_fields("stocks"), e.g. {"market_cap": [2e9, null], "forward_pe": [5, 15], "revenue_growth_pct": [10, null], "debt_to_equity": [null, 1]}. Percent fields are in percent (10 = 10%). sector/industry/country/exchange: lists,

Find and rank many areas at once (states, counties, metros, cities or ZIP codes) from a ready-made scorecard of market, price, rent, crime, income and affordability numbers. START HERE for broad real-estate questions such as where to buy, rent out or live. One level per call, ranked on home value and its 1-year change, rent and rent yield, price forecast, market speed (metros), homes f

Find M&A deals across the market (default: the 12 months up to the newest deal). stage e.g. ["Completed"] or ["Announced/Pending"]; sectors and countries are partial matches (e.g. target_sector ["Health Care"], target_country ["United States"]); values in USD millions. Compact rows (date, buyer, target, tickers, value, stage, sectors, countries); use get_ma_transactions for full detail

List every filter (API parameter) a tool accepts, with descriptions, for use in its `filters` argument. tool is a tool name such as 'search_properties' or 'get_financial_statements'.