API Documentation
Base URL: https://api.dataporium.io
203 endpoints across 42 categories · MCP server for AI assistants
About the API
DataPorium Financial Data API
The DataPorium API is a REST financial data API that delivers real-time and historical market data across stocks, ETFs, crypto, forex, and commodities, plus company fundamentals, news, and macro indicators. Authenticate with an API key, send a request, and get clean JSON, built for developers, analysts, and AI agents.
Every endpoint returns structured JSON over HTTPS, so you can pull quotes, charts, financial statements, and screening data into your own apps, dashboards, or models with a single request. Browse the reference above to explore endpoints by category, then grab your key from the pricing page to start building.
Frequently asked questions
What can the DataPorium API do?
Access real-time and historical market data across stocks, ETFs, crypto, forex, and commodities, plus company fundamentals, news, and macro indicators, all through a single REST API.
How do I authenticate?
Include your API key with each request, either in an "apikey" request header or as a query parameter (?apikey=YOUR_API_KEY). We recommend the header, because it keeps your key out of server and proxy logs. Sign up for an account to receive your key.
What is the rate limit?
Up to 600 requests per minute. Responses are JSON, so they integrate easily with any language or AI agent.
Can I use DataPorium data inside ChatGPT, Claude or other AI assistants?
Yes. DataPorium runs a Model Context Protocol (MCP) server at https://mcp.dataporium.io/mcp. Add it as a custom connector in ChatGPT or Claude, or as an MCP server in Claude Code, Cursor, VS Code, Windsurf or Gemini CLI, using your DataPorium API key. The assistant can then query company fundamentals, prices, financial statements, news, economic data, home listings and property details, housing market data and research screeners in plain language.
How do I connect the DataPorium MCP server?
Use the server URL https://mcp.dataporium.io/mcp with your API key as an Authorization: Bearer header, an X-API-Key header, or ?apikey=YOUR_API_KEY in the URL for apps that only accept an address. Step-by-step instructions for each AI app are in the MCP section of this page.
Quick Start
Get Your API Key
Sign up for an account to receive your unique API key
Authentication
Include your API key in requests using query parameter or header
?apikey=YOUR_API_KEYapikey: YOUR_API_KEYYou can send the key in an "apikey" request header instead of the URL. We recommend the header, because a key in a URL can end up in server and proxy logs, and a header keeps it out of them.
Make Your First Request
Rate limit: 600 requests per minute
Use DataPorium inside AI assistants (MCP)
Model Context ProtocolDataPorium runs a Model Context Protocol (MCP) server. Connect it once and ChatGPT, Claude, Gemini CLI, Grok (xAI API), Cursor and other MCP clients can query the same data as this API in plain language: company fundamentals, prices, financial statements, news, US economic data, home listings and property details, housing market data by city and ZIP, and research screeners. Every call uses your own API key, so your plan limits apply exactly as they do for the REST API.
Server address
https://mcp.dataporium.io/mcpTransport: Streamable HTTP. Health check: mcp.dataporium.io/health
Your API key
Use the API key from your account settings. Send it as the header Authorization: Bearer YOUR_API_KEY, as X-API-Key, or in the address as ?apikey=YOUR_API_KEY for apps that only accept a URL. MCP access is included with Premium plans.
Set up in your AI app
Claude.ai (web), Claude Desktop and the Claude mobile apps. Custom connectors need a paid Claude plan; on Team and Enterprise plans an owner adds the connector for the organization.
- 1Open Settings, then Connectors, then Add custom connector.
- 2Name: Dataporium. Remote MCP server URL: paste the address below (it contains your API key).
- 3Click Add. In a chat, open the tools menu (the plus or sliders icon) and turn Dataporium on.
- 4Ask a question, for example "Compare the housing market in Austin and Dallas using Dataporium".
https://mcp.dataporium.io/mcp?apikey=YOUR_API_KEYWhat the assistant can access (46 tools)
Companies and stocks
Company profiles, prices of stocks, ETFs and indexes, financial statements, business segments down to product and country level, SEC filings, earnings transcripts, presentations, insider trades, stock trades reported by members of Congress, short interest with days to cover and the most shorted stocks (get_short_interest), federal contracts, lobbying, US patents, shareholders, options
Industries
US banks and credit unions with their quarterly numbers, branches and failures, consumer complaints about financial companies (get_bank_data), vehicle and consumer product recalls, crash test star ratings and owner complaint counts by make and model and trucking carrier safety (get_recalls), airline on-time performance and passenger traffic (get_airline_data), and yearly pay offered in work-visa filings by employer, job group and place (get_salaries)
Elections
US election results: president, Senate, House, governors, state offices and ballot measures with winners, margins, shift since the last election, turnout, partisan lean and bellwether counties (get_election_results). The housing area tool also returns the elections of any state, county or city.
Markets
Stock, forex and crypto news, gainers and losers, sector and industry performance, earnings and IPO calendars, exchange hours, commodities, FX rates, weekly futures positioning by trader type (get_futures_positioning)
Economy and energy
US economic series (GDP, CPI, jobs, mortgage rates), US energy data, healthcare market data, US drug approvals and clinical trials
Healthcare providers
Every US hospital with beds, star ratings, owner, revenue and profit, the health systems that run them, every doctor and clinician by NPI and specialty, group practices, hospital financials by year and quality measures, Medicare procedures, lab tests, hospital stays by DRG, prescriptions by doctor and drug, drug spending by company, Medicaid drugs and payments from drug and device companies to doctors
Real estate
Four tools. search_properties finds US homes for sale, pending, for rent, sold or off the market, with true listing dates, relists and price cuts. get_property gives one home in full by address or ID, with its timeline, nearby comparisons and a monthly payment you can recalculate. search_housing_areas finds and ranks states, counties, metros, cities and ZIP codes. get_housing_area_insights gives one area in full: market, property tax, crime, demographics, climate and neighborhood profile
Research screeners
Rank 45,000 companies or every US city and ZIP on dozens of metrics in one call, screen M&A deals, then drill into the best matches
Example questions
- Which US cities have a gross rent yield above 7% with a growing population and low crime?
- Find profitable US stocks with a forward P/E below 15, revenue growth above 10% and insider buying, then compare the top five.
- What did Nvidia report last quarter, and how does its valuation compare with the sector?
- How have mortgage rates and home values in Phoenix changed over the past year?
- Show homes in Austin, Texas under $600,000 that had a price cut in the last 7 days.
- Look up 110 Coastal Garden, Irvine CA. What would the monthly payment be with 10% down and a 6% interest rate?
- Compare Irvine, CA and Plano, TX on crime and home value.
- Which hospitals in Texas have the most beds, and which health systems own them?
- How did Maricopa County vote in 2024 compared with 2016, and is it a bellwether?
Treat a server address that contains your API key like a password: do not share screenshots of it. If it leaks, create a new key in your account settings and the old one stops working. Limits: 600 API requests per minute and 150 tool calls per hour per key through MCP; answers are capped at 100 rows per call.
API Reference (203 endpoints)
Error Codes
| Code | Description |
|---|---|
| 401 | API key required - Include your API key in the request |
| 403 | Invalid or expired API key, or subscription inactive |
| 429 | Rate limit exceeded - Maximum 600 requests per minute |
| 500 | Internal server error - Please try again or contact support |