Search Tickers

Five endpoints for resolving stock tickers from different identifiers: symbol/name, company name only, SEC CIK, CUSIP, and ISIN. All return the ticker symbol, company name, exchange, and security type.

Search by Ticker

The most flexible search endpoint, matching against both ticker symbols and company names. Use this to power search bars and autocomplete inputs.

GEThttps://api.roic.ai/v2/tickers/search

Query parameters

querystringrequired

Stock symbol or company name to search for.

Example: AAPL
limitnumber

Maximum number of results to return.

Default: 10
exchangestring

Filter results to a specific stock exchange.

Example: NASDAQ
formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel
Request
curl "https://api.roic.ai/v2/tickers/search?apikey=YOUR_API_KEY&query=AAPL"
Response
200 OK
[
  {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "exchange_name": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "type": "Common Stock"
  }
]

Response

Response fields

symbolstring

The ticker symbol as it trades on its exchange, e.g. AAPL. Use it as the identifier when calling other v2 endpoints.

namestring

Human-readable name of the company or security, e.g. Apple Inc.. Use it for display; it is not a stable identifier.

exchange_namestring

Full display name of the listing exchange, e.g. NASDAQ Global Select.

exchangestring

Short code of the listing exchange, e.g. NASDAQ. Pass it to the exchange filter parameters to narrow searches to one venue.

typestring

The kind of security this ticker represents, e.g. Common Stock, ETF, or Preferred Stock.

Search by Company Name

Matches exclusively against company names, not ticker symbols. Useful when your data source provides company names rather than symbols.

GEThttps://api.roic.ai/v2/tickers/search/name

Query parameters

querystringrequired

Company name to search for.

Example: Apple
limitnumber

Maximum number of results to return.

Default: 10
exchangestring

Filter results to a specific stock exchange.

Example: NASDAQ
formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel
Request
curl "https://api.roic.ai/v2/tickers/search/name?apikey=YOUR_API_KEY&query=Apple"
Response
200 OK
[
  {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "exchange_name": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "type": "Common Stock"
  },
  {
    "symbol": "APLE",
    "name": "Apple Hospitality REIT, Inc.",
    "exchange_name": "New York Stock Exchange",
    "exchange": "NYSE",
    "type": "Common Stock"
  }
]

Response

Response fields

symbolstring

The ticker symbol as it trades on its exchange, e.g. AAPL. Use it as the identifier when calling other v2 endpoints.

namestring

Human-readable name of the company or security, e.g. Apple Inc.. Use it for display; it is not a stable identifier.

exchange_namestring

Full display name of the listing exchange, e.g. NASDAQ Global Select.

exchangestring

Short code of the listing exchange, e.g. NASDAQ. Pass it to the exchange filter parameters to narrow searches to one venue.

typestring

The kind of security this ticker represents, e.g. Common Stock, ETF, or Preferred Stock.

Search by CIK

Resolve a SEC CIK (Central Index Key) number to a ticker symbol. Pass the CIK as a zero-padded 10-digit string (e.g., 0000320193 for Apple) - Essential for workflows that process SEC EDGAR filings.

GEThttps://api.roic.ai/v2/tickers/search/cik/{cik}

Path parameters

cikstringrequired

SEC CIK (Central Index Key) number.

Example: 0000320193

Query parameters

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel
Request
curl "https://api.roic.ai/v2/tickers/search/cik/0000320193?apikey=YOUR_API_KEY"
Response
200 OK
[
  {
    "cik": "0000320193",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "exchange_name": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "type": "Common Stock"
  }
]

Response

Response fields

cikstring

The SEC Central Index Key (CIK) of the filer, a zero-padded 10-digit string, e.g. 0000320193. Use it to cross-reference filings on SEC EDGAR.

symbolstring

The ticker symbol as it trades on its exchange, e.g. AAPL. Use it as the identifier when calling other v2 endpoints.

namestring

Human-readable name of the company or security, e.g. Apple Inc.. Use it for display; it is not a stable identifier.

exchange_namestring

Full display name of the listing exchange, e.g. NASDAQ Global Select.

exchangestring

Short code of the listing exchange, e.g. NASDAQ. Pass it to the exchange filter parameters to narrow searches to one venue.

typestring

The kind of security this ticker represents, e.g. Common Stock, ETF, or Preferred Stock.

Search by CUSIP

Resolve a 9-character CUSIP code to a ticker symbol. CUSIP numbers are found in brokerage statements, trade confirmations, and 13F filings.

GEThttps://api.roic.ai/v2/tickers/search/cusip/{cusip}

Path parameters

cusipstringrequired

CUSIP number — a 9-character alphanumeric code.

Example: 037833100

Query parameters

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel
Request
curl "https://api.roic.ai/v2/tickers/search/cusip/037833100?apikey=YOUR_API_KEY"
Response
200 OK
[
  {
    "cusip": "037833100",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "exchange_name": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "type": "Common Stock"
  }
]

Response

Response fields

cusipstring

The CUSIP of the security, a 9-character alphanumeric code that uniquely identifies North American securities, e.g. 037833100.

symbolstring

The ticker symbol as it trades on its exchange, e.g. AAPL. Use it as the identifier when calling other v2 endpoints.

namestring

Human-readable name of the company or security, e.g. Apple Inc.. Use it for display; it is not a stable identifier.

exchange_namestring

Full display name of the listing exchange, e.g. NASDAQ Global Select.

exchangestring

Short code of the listing exchange, e.g. NASDAQ. Pass it to the exchange filter parameters to narrow searches to one venue.

typestring

The kind of security this ticker represents, e.g. Common Stock, ETF, or Preferred Stock.

Search by ISIN

Resolve a 12-character ISIN code to a ticker symbol. ISIN is the global standard used by international brokers, clearinghouses, and data vendors.

GEThttps://api.roic.ai/v2/tickers/search/isin/{isin}

Path parameters

isinstringrequired

ISIN — a 12-character alphanumeric code starting with a country code.

Example: US0378331005

Query parameters

formatstring

Response format. Use json for JSON (default) or excel for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: jsonexcel
Request
curl "https://api.roic.ai/v2/tickers/search/isin/US0378331005?apikey=YOUR_API_KEY"
Response
200 OK
[
  {
    "isin": "US0378331005",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "exchange_name": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "type": "Common Stock"
  }
]

Response

Response fields

isinstring

The ISIN of the security, a 12-character code that starts with a two-letter country code, e.g. US0378331005. It identifies the security globally, across all its listings.

symbolstring

The ticker symbol as it trades on its exchange, e.g. AAPL. Use it as the identifier when calling other v2 endpoints.

namestring

Human-readable name of the company or security, e.g. Apple Inc.. Use it for display; it is not a stable identifier.

exchange_namestring

Full display name of the listing exchange, e.g. NASDAQ Global Select.

exchangestring

Short code of the listing exchange, e.g. NASDAQ. Pass it to the exchange filter parameters to narrow searches to one venue.

typestring

The kind of security this ticker represents, e.g. Common Stock, ETF, or Preferred Stock.

Use Cases

  • Power a real-time ticker search bar or autocomplete input
  • Resolve company names from news articles to ticker symbols
  • Map SEC EDGAR filings (CIK) to ticker symbols for automated analysis
  • Reconcile brokerage holdings identified by CUSIP
  • Normalize international data that uses ISIN identifiers
  • Validate user-entered ticker symbols before downstream API calls

Related Endpoints