The Wall St. Rank API gives you access to our extensive data set of fund manager holding, trading activity, portfolio details, trends and unique insights.
In addition to the endpoints and responses listed below, we also provide custom endpoints which contain more detailed responses, custom rankings and unique filtering tailored to our partners' unique data requirements.
If you don't find what you're looking for below, please get in touch and we'll give you access to a new custom endpoint tailored to your needs.
The Wall St. Rank API adheres to REST principles. Our API has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication and verbs.
The Wall St. Rank API uses API keys for authentication. You can get your API key by contacting us.
You can use your API key as a bearer token in the Authorization requests header.
Alternatively, you can pass your API key in the api_key query parameter.
When possible, we recommend using the Authorization header method over the query parameter method.
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
We uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, the ticker is invalid, etc.). Codes in the 5xx range indicate an error with our servers (these are rare).
Retrieve fund manager confidence stats for the stock with the given ticker
Parameters
tickerThe ticker symbol of the stock
Retrieve company insider confidence stats for the stock with the given ticker.
Parameters
tickerThe ticker symbol of the stock
Retrieve analyst confidence stats for the stock with the given ticker.
Parameters
tickerThe ticker symbol of the stock
Retrieve news confidence stats for the stock with the given ticker.
Parameters
tickerThe ticker symbol of the stock
Retrieve fund portfolios.
Retrieve the holdings of the given fund portfolio
Parameters
idID of the fund portfolio
Retrieve stocks ranked by the number of funds holding in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the number of funds holding the stock in their top 10 holdings in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the number of funds that opened a new position in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the number of funds that closed their existing position in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the number of funds that increased their existing position in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the number of funds that reduced their existing position in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the total value of Call options bought by funds in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the total value of Put options bought by funds in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of current, change, change_percent.
Defaults to current.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net number of new positions opened by funds (new positions - closed positions) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, new, closed.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net number of positions closed by funds (closed positions - new positions) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, new, closed.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net number of positions increased by funds (increased positions - reduced positions) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, increased, reduced.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net number of positions reduced by funds (reduced positions - increased positions) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, increased, reduced.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net amount of Call options bought by funds (calls bought - puts bought) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, calls, puts.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve stocks ranked by the net amount of Put options bought by funds (puts bought - calls bought) in the latest reporting quarter.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of net, calls, puts.
Defaults to net.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
typeThe type of security to retrieve.
One of stock, etf.
Returns all types if not specified.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
Retrieve analyst firms.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
min_ratingsThe minimum number of ratings to filter by.
Defaults to 1.
Retrieve details of the firm with the given ID.
Parameters
idThe ID of the firm to retrieve.
Retrieve analysts details.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
firm_idThe ID of the analyst firm to filter by.
Returns analysts from all firms if not specified.
min_ratingsThe minimum number of ratings to filter by.
Defaults to 1.
Retrieve details of the analyst with the given ID.
Parameters
idThe ID of the analyst to retrieve.
Retrieve analyst ratings.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
tickersOne or more stock tickers separated by commas.
Returns rating for all tickers if not specified.
firm_idThe ID of the analyst firm to filter by.
Returns ratings from all firms if not specified.
analyst_idThe ID of the analyst to filter by.
Returns rating from all analysts if not specified.
Retrieve stocks ranked by upside potential as determined by analyst price targets received in the last 3 months.
Parameters
pageThe page number to retrieve.
Defaults to 1.
page_sizeThe number of items per page.
If specified, must be between 1 and 10000 inclusive.
Defaults to 100.
sort_byThe field to sort the results by.
One of upside_percent, bullish_percent, ratings_count.
Defaults to upside_percent.
sort_dirThe order to sort the results by.
One of asc, desc.
Defaults to desc.
market_capThe market cap of securities to retrieve.
One or more of mega-cap, large-cap, mid-cap, small-cap, micro-cap, separated by commas.
Returns all market caps if not specified.
min_ratings_countThe minimum number of analyst ratings required for a stock in the result set.
Defaults to 3.
Retrieve stocks ranked by news positivity.
Parameters
periodThe period used to calculate the news positivity.
One of 1-day, 7-day, 14-day, 1-month, 3-month, 6-month.
Defaults to 1-month.
min_articlesThe minimum number of articles required within the above period for the stock to be returned in the result set.
Defaults to 3.
min_positive_percentThe minimum positive articles percent required within the above period for the stock to be returned in the result set.
Defaults to 0.