Financial Data API

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 — matches 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"
Response200 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"
Response200 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"
Response200 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"
Response200 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"
Response200 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