Ticker API

Frequently Asked Questions

• Can I use the Ticker API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Ticker 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 Ticker 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 Ticker 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.

• Which ticker formats can I use?

  Write the symbol the way you normally would. Share classes work as BRK.B, BRK-B, BRK/B or BRKB; preferred shares as BAC.PRL, BAC-PL or BAC^L; warrants and units as BKKT.WS or AAC.U. For non-US stocks, add the exchange suffix (SHEL.L, 7203.T, RY.TO) or use an exchange prefix (LON:SHEL, TSE:7203). The same formats work on every stock endpoint, including the Stock Price API and the Earnings Call Transcript API.

• What is the difference between the /v1/ticker and /v1/tickersearch endpoints?

  /v1/ticker looks up a full company profile for a known symbol via the ticker parameter, while /v1/tickersearch takes a company name and returns up to 100 matching ticker symbols. Note that /v1/tickersearch is a premium-only endpoint, which you can unlock on the pricing page.

• What fields does the /v1/ticker response include?

  A successful /v1/ticker request returns a company profile with fields such as name, logo_url, chief_executive_officer, address, exchange, website, phone_number, and identifiers like cik, cusip, and isin. It also includes the company's sector and industry in the API Ninjas classification (available for all companies), plus a sic_code and sic_description for US-listed companies. Premium-only fields including latest_price, latest_market_cap, and the classification fields require a paid plan; for standalone price or market-cap data see the Stock Price API and Market Cap API.

• Does the Ticker API return a company logo?

  Yes. Each /v1/ticker response includes a logo_url field pointing to a PNG of the company's logo. It is a premium-only field, so free-tier requests receive an upgrade prompt in its place. When we do not have a logo for a company the field is null rather than a broken link, so a non-null logo_url always resolves to a real image and you can render it without a fallback check. Logos are the trademarks of their respective owners and are provided for identification only; API Ninjas is not affiliated with or endorsed by the companies shown. For company logos outside the listed-equity universe, see the Logo API.

• Does the Ticker API return a company's sector or industry?

  Yes. Each /v1/ticker response includes a sector and industry in the API Ninjas classification (e.g. Technology / Semiconductors) for all companies, US and international. US-listed companies additionally include a sic_code and sic_description from their SEC filing. These classification fields are premium only.

• How do I narrow down ticker search results when many companies share a name?

  Pass the optional negative_keywords parameter to /v1/tickersearch as a comma-separated list (e.g. pineapple,appleseed); any company name containing one of those keywords is excluded case-insensitively, and results are sorted by exchange size so the most common listings appear first. Browse more finance endpoints in the API catalog.

• How do I get a stock's dividend yield?

  Call /v1/ticker with the stock's ticker. The dividend_yield field is the trailing 12-month yield as a percentage (for example, 2.69 means 2.69%), and latest_dividend is the total dividend per share paid over the same 12 months. Both are premium-only fields and are 0 for companies that pay no dividend.

• Are the prices returned by the Ticker API real-time?

  The latest_price, latest_market_cap, latest_dividend, and dividend_yield fields are premium only and are not available on the free tier; you can unlock them on the pricing page. For dedicated fund data, also see the ETF API and Mutual Fund API.