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

apikeystringrequired

Your API key for authentication.

querystringrequired

Stock symbol or company name to search for.

Example: AAPL
limitnumberoptional

Maximum number of results to return.

Default: 10
exchangestringoptional

Filter results to a specific stock exchange.

Example: NASDAQ
formatstringoptional

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

Default: jsonValues: json, excel
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"
  }
]

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

apikeystringrequired

Your API key for authentication.

querystringrequired

Company name to search for.

Example: Apple
limitnumberoptional

Maximum number of results to return.

Default: 10
exchangestringoptional

Filter results to a specific stock exchange.

Example: NASDAQ
formatstringoptional

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

Default: jsonValues: json, excel
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"
  }
]

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

apikeystringrequired

Your API key for authentication.

formatstringoptional

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

Default: jsonValues: json, excel
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"
  }
]

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

apikeystringrequired

Your API key for authentication.

formatstringoptional

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

Default: jsonValues: json, excel
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"
  }
]

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

apikeystringrequired

Your API key for authentication.

formatstringoptional

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

Default: jsonValues: json, excel
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"
  }
]

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