findStock

The findStock API is to search for a stock based on ticker symbol or name

Query Parameters:

Parameter Meaning Data Type
T Application Key which authenticates you with cloudquote (required) Base64 string
search A compound query to execute String
sort The sorting algorithm to use to sort/rank results String
limit Number of results to return. Default: 25 Number

JSON Response:

The response is the same as the getStockPrice API, detailed below.

Search String / Sort String:

The search string is a pipe | separated list of search queries, which evaluate one after another from left to right in order to fill in the desired number of results passed in the "limit" order.

Each search string executes against the securities index, matching on fields such as Ticker Symbol, or Company Name. Each index entry is a string in the format TYPE/VALUE, and can either be matched exactly, or with a prefix match.

If a particular query returns more than one result, the result is sorted using the algorithm chosen in the sort= parameter

For example, if a user were to enter the query GOOG, an application might construct the following compound query:

SYMBOL/GOOG|NAME/GOOG|SYMBOL/GOOG*|NAME/GOOG*|WORD/GOOG|WORD/GOOG*

Let's break that down into each piece

SYMBOL/GOOG

  • First, we look for any securities with a ticker symbol that matches the string GOOG exactly

NAME/GOOG

  • Next, we look for any securities with a name that matches the string GOOG exactly

SYMBOL/GOOG*

  • Next, we look for any securities with a ticker symbol that starts with the characters GOOG

NAME/GOOG*

  • Next, we look for any securities with a name that starts with the characters GOOG

WORD/GOOG

  • Next, we look for any securities with a word within the name that matches the string GOOG exactly

WORD/GOOG*

  • Next, we look for any securities with a word within the name that starts with the characters GOOG

Sort Algorithms:

Currently, the only supported sort is "Popularity", which sorts the results based upon a popularity ranking. The base popularity ranking for a security is based upon the popularity/credibility of the exchange, and more popularity is added for Major Indexes (Dow, Nasdaq, S&P), Companies in the S&P 500 index, and other noteworthy securities that experience above average interest.

Passing an empty or invalid sort= parameter returns the results in the same order they were indexed in.

About the Vendor

FinancialContent is one of the largest providers of stock market data, business news and content syndication tools for online publishers