Frequently asked questions

Answers about Mboum's market data, API keys, plans, and billing. If your question isn't covered here, email [email protected].

Mboum is a stock market research website and a market data API. On the website you can screen US stocks, check top movers, unusual options activity, IV rank, insider trades, and the earnings, dividend, and IPO calendars, and open a quote page for any symbol. The API returns this kind of data as JSON so you can use it in your own code.
It depends on the data set. Quotes, movers, and options activity update during market hours but can lag the market. Calendars, fundamentals, and analyst data update less often. Mboum doesn't guarantee real-time data, so don't rely on it for time-sensitive trades.
Create a free account and verify your email address. Then open Manage API Keys from your dashboard and create a key. You can create more than one key and revoke any key at any time.

Yes. Connect Claude Code, Cursor, VS Code, or another MCP client to https://api.mboum.com/mcp with your API key. Each tool call counts as a normal request by the endpoint's weight. Setup steps are on the AI agents page.

Each successful response (HTTP 200) counts against your allowance by the endpoint's weight. Failed requests don't count. Most endpoints count as 1 request. Heavier ones count as 2, including the stock screener, multi-symbol quotes, stock modules, options chains and options scanners, technical indicators, the earnings calendar, and several v2 stock endpoints such as financials and SEC filings. The crypto coin list counts as 5.
Requests above your allowance are refused until the next usage period starts, unless you have turned on overage. You can upgrade at any time from your billing page.
Yes. Paid plans can be billed monthly or yearly. A yearly plan is charged once for the full year and costs less than 12 monthly payments on most plans. The pricing page shows the saving for each plan.
Credit and debit cards, processed by Stripe. You can update your card from your billing page.
Cancel from your billing page. You can end the subscription at the end of the current billing period and keep access until then, or end it immediately. Until the period ends you can resume a subscription you cancelled. The Terms state that payments are not refunded.
Not without written approval. The Terms don't allow you to share or redistribute Mboum data, or results derived from it, with third parties unless Mboum approves it in writing. They also require you to delete the data when your subscription ends.
Mboum collects market data from third-party sources and processes it before showing it on the site or returning it from the API. Mboum doesn't guarantee that every figure is accurate or complete (see the Terms), so check anything important against company filings or your broker before you act on it.
No. Mboum shows market data for information only. Unusual options volume, analyst ratings, and screener results describe what happened or what others estimate. They don't tell you whether to buy or sell.
Send it in the Authorization header as Bearer YOUR_API_KEY, or add it as the apikey query parameter. Keep keys out of public code. If a key leaks, revoke it and create a new one. The API documentation has examples in Python, PHP, JavaScript, and Bash.
Every plan, including Free, can call all the market data endpoints, including options. Plans differ by monthly request allowance and by whether commercial use is allowed. Monthly allowances: Free 500, Investor 10,000, Business 50,000, Developer 250,000, Enterprise 2,500,000, and Institutional 5,000,000 requests. Current prices are on the pricing page.
Allowances are monthly. Each usage period starts on the day of the month your subscription started, so it may not match the calendar month. Yearly plans get the same allowance each month. Unused requests don't carry over.
Overage is optional and stays off until you turn it on. On a paid plan billed by card, turn it on from the Subscriptions section of your billing page. Requests above your allowance then keep working up to a cap, and the extra requests are charged to your card after the usage period ends, for each 1,000 extra requests or part of 1,000. Rates and caps: Investor $1.50 per 1,000 (up to 50,000 extra), Business $1.05 (up to 250,000), Developer $0.50 (up to 1,250,000), Enterprise $0.09 (up to 12,500,000), and Institutional $0.05 (up to 25,000,000). Amounts under $0.50 carry over to the next period. If an overage payment fails, overage pauses until it is paid. The Free plan has no overage.
Your card is charged when you subscribe and then at the start of each billing period, monthly or yearly. If you turn on overage, it is charged separately after each monthly usage period ends.
Yes, from your billing page. Upgrades and switches between monthly and yearly billing take effect right away, and you pay the prorated difference at that time. Downgrades to another paid plan also take effect right away, and the unused part of your current plan is credited to your next invoice. A move to the Free plan happens at the end of your current billing period.
The Developer, Enterprise, and Institutional plans include commercial use. Under the Terms, the Investor plan is for personal use only, and a business can't use a personal plan, even internally, without written approval from Mboum. If you're not sure which plan covers your use, email [email protected] before you subscribe.
Email [email protected] or use the contact form. For API questions, include your account email and the endpoint and parameters you called, but never your API key.