Market Cap API

Frequently Asked Questions

• Can I use the Market Cap API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Market Cap API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

• How do I get an API key and start using the Market Cap API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

• What happens if I exceed my quota for the month?

  Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.

• What happens if a request to the Market Cap API fails?

  The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

• How do I look up the market cap of a specific company?

  Send a GET request to the /v1/marketcap endpoint with the required ticker parameter set to the stock symbol (e.g. NVDA or AAPL). You can pair it with the Ticker API to first resolve a company name into its symbol.

• What fields does the Market Cap API response include?

  Each response is a JSON object containing ticker, name (company name), market_cap (in the exchange's local currency), currency (e.g. USD), and updated (a Unix timestamp in seconds). If the request is unsuccessful you'll receive an error instead.

• How fresh is the market cap data?

  The updated field gives the Unix timestamp of the returned data, and freshness depends on your plan: premium members get live market cap data while free users receive the market cap at the close of the most recent completed trading session (see the pricing page for plans). For real-time per-share quotes, see the Stock Price API.

• What are some use cases for the Market Cap API?

  It's ideal for ranking companies by size, building stock screeners, or tracking valuation changes across major global exchanges using the market_cap and currency fields. It pairs well with the ETF API and Stock Price API for broader financial dashboards.