Ticker API
The Ticker API provides comprehensive company profile information for publicly traded companies, including executive details, financial metrics, identifiers, and contact information.
Available endpoints:
- /v1/ticker - Get detailed company profile information for any given ticker symbol
- /v1/tickersearch - Search for ticker symbols by company name
From 3,366 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 255ms | 276ms | 307ms | 499ms | 1130ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
https://api.api-ninjas.com/v1/ticker
Returns comprehensive company profile information including company name, CEO, address, financial data, exchange information, identifiers (CIK, CUSIP, ISIN), and latest earnings information when available.
Parameters
tickerrequiredStock ticker symbol (e.g.,
AAPL).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response Fields
A JSON object with the following fields or an error if the request is unsuccessful.
nameCompany name.
tickerStock ticker symbol.
logo_urlPremium onlyURL of the company logo as a PNG, or
nullwhen no logo is available for that company. A non-null value always points to a working image, so you can render it without a fallback check.chief_executive_officerName of the CEO.
addressCompany address object containing
address,city,state, andzipfields.latest_pricePremium onlyLatest stock price.
latest_market_capPremium onlyLatest market capitalization.
latest_dividendPremium onlyLatest dividend payment.
cikCentral Index Key (SEC identifier).
cusipCommittee on Uniform Securities Identification Procedures number.
isinInternational Securities Identification Number.
exchangeStock exchange where the company is listed (e.g.,
NASDAQ,NYSE).websiteCompany website URL.
phone_numberCompany phone number.
ipo_datePremium onlyInitial public offering date in YYYY-MM-DD format.
latest_earningsLatest earnings information object containing
yearandquarterfields when available.sectorPremium onlyCompany sector in the API Ninjas classification (e.g. Technology, Financials, Health Care). Available for all companies.
industryPremium onlyCompany industry (sub-sector) within its sector (e.g. Semiconductors, Banks, Airlines). Available for all companies.
sic_codePremium onlyStandard Industrial Classification (SIC) code from the company's SEC filing. US-listed companies only (null for non-US).
sic_descriptionPremium onlyHuman-readable description of the SIC code. US-listed companies only (null for non-US).
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/ticker?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/ticker?ticker=AAPL" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Premium only
https://api.api-ninjas.com/v1/tickersearch
Returns a list of at most 100 ticker symbols matching a given company name. Results are sorted by exchange size (largest exchanges first) to prioritize the most common listings.
Parameters
namerequiredCompany name to search for (e.g.,
Apple).negative_keywordsoptionalComma-separated list of keywords to filter out from results. If any negative keyword appears in a company name (case-insensitive), that result will be excluded (e.g.,
pineapple,appleseed).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response Fields
A JSON array of objects (100 max), each containing the following fields, or an error if the request is unsuccessful.
tickerStock ticker symbol.
company_nameFull company name.
exchangeStock exchange where the company is listed (e.g.,
NASDAQ,NYSE).logo_urlURL of the company logo as a PNG, or
nullwhen no logo is available for that company. Useful for rendering search or autocomplete results with a brand mark beside each match.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/tickersearch?name=AppleHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/tickersearch?name=Apple" \
-H "X-Api-Key: YOUR_API_KEY"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 theX-Api-Keyheader 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.What is the difference between the /v1/ticker and /v1/tickersearch endpoints?
/v1/tickerlooks up a full company profile for a known symbol via thetickerparameter, while/v1/tickersearchtakes a companynameand returns up to 100 matching ticker symbols. Note that/v1/tickersearchis a premium-only endpoint, which you can unlock on the pricing page.What fields does the /v1/ticker response include?
A successful/v1/tickerrequest returns a company profile with fields such asname,logo_url,chief_executive_officer,address,exchange,website,phone_number, and identifiers likecik,cusip, andisin. It also includes the company'ssectorandindustryin the API Ninjas classification (available for all companies), plus asic_codeandsic_descriptionfor US-listed companies. Premium-only fields includinglatest_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/tickerresponse includes alogo_urlfield 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 isnullrather than a broken link, so a non-nulllogo_urlalways 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/tickerresponse includes asectorandindustryin the API Ninjas classification (e.g. Technology / Semiconductors) for all companies, US and international. US-listed companies additionally include asic_codeandsic_descriptionfrom 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 optionalnegative_keywordsparameter to/v1/tickersearchas 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.Are the prices returned by the Ticker API real-time?
Thelatest_price,latest_market_cap, andlatest_dividendfields 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.