Track Leading Securities in the Current Trading Session

This API is designed for developers building a wide range of applications, from creating market movers dashboards to highlight trending securities, developing algorithmic trading triggers to react to live market signals, building investor research tools to analyze price movements, monitoring portfolio performance in real time, creating market alert systems for significant price or volume changes, training AI models to predict market trends, and using AI-driven sentiment analysis to gauge market mood from trading activity.

Key Features

• 📈 Dynamic Security Lists - Access curated lists of top-performing securities.
  Users can query predefined lists like MOSTACTIVE, PERCENTGAINERS, PERCENTLOSERS, or POPULAR to retrieve data on securities driving market activity. This feature is perfect for applications that highlight trending stocks or funds, allowing developers to showcase the most relevant market movers in real time.

• 🔍 Customizable Filtering - Tailor results with parameters like security type and price range.
  By specifying parameters such as type (e.g., STOCK, FUND) or minPrice, users can filter results to focus on specific market segments. This enables targeted data retrieval for niche applications, such as dashboards focused on high-value stocks or specific asset classes.

• ⚡ Real-Time Price and Volume Data - Get up-to-date bid, ask, and trade metrics.
  The API provides real-time fields like Price, Bid, Ask, and Volume, allowing users to monitor live market activity. Developers can use these metrics to power trading interfaces or alert systems that react instantly to price movements or volume spikes during the trading session.

• 📊 Rich Historical Context - Include performance metrics like moving averages and historical highs/lows.
  With fields like MovingAverage50, MovingAverage200, and High52/Low52, users can access contextual data to analyze a security’s performance over time. This is ideal for applications that combine real-time data with historical trends for deeper market insights.

Query Parameters

The API accepts the following parameters to customize your request:

Parameter	Description	Data Type
T	Application Key which authenticates you with CloudQuote (required)	Base64 string
list	The list of securities to search (e.g., MOSTACTIVE, PERCENTGAINERS)	String
type	The type of security (e.g., STOCK, FUND)	String
limit	The number of securities to return	Integer
calcChange	Whether to calculate the Price & Percent change for a security	Boolean (0 or 1)
minPrice	Minimum price of securities to include	Number

Security Lists

The API supports the following predefined lists for querying leading securities:

List Code	What the List Contains
MOSTACTIVE	The most active securities based on dollar volume traded.
PERCENTGAINERS	The largest percentage gainers compared to the previous day’s closing price.
PERCENTLOSERS	The largest percentage losers compared to the previous day’s closing price.
POPULAR	A hand-curated list of popular securities.

Available Data Fields

Each API call returns a collection of quote results with the following fields:

Field	Description	Data Type
Ask	Latest Asking Price	Number
AskSize	Latest Asking Price Size	Number
AvgVolume1M	Average Volume (Trailing 1 Month)	Number
AvgVolume1W	Average Volume (Trailing 1 Week)	Number
AvgVolume3M	Average Volume (Trailing 3 Month)	Number
AvgVolume52	Average Volume (Trailing 52 Weeks)	Number
AvgVolume6M	Average Volume (Trailing 6 Month)	Number
AvgVolumeYTD	Average Volume (Since Jan 1)	Number
Bid	Latest Bid Price	Number
BidSize	Latest Bid Price Size	Number
Change	Change of the Price	Number
ChangePercent	Percent Change of the Price	Number
ChartEndTime	The time to end a chart of this security	Unix Epoch Time
ChartStartTime	The time to start a chart of this security	Unix Epoch Time
Delay	Delay in minutes for the exchange	Number
ExchangeName	Name of Exchange	String
ExchangePrefixCode	Prefix Code of Exchange	String
ExchangeShortName	Short Name of Exchange	String
High	Today's High price	Number
High1M	High Price (Trailing 1 Month)	Number
High1MDate	One Month High Price Date	Unix Epoch Time in ms
High1W	High Price (Trailing 1 Week)	Number
High1WDate	One Week High Price Date	Unix Epoch Time in ms
High3M	High Price (Trailing 3 Month)	Number
High3MDate	3 Month High Price Date	Unix Epoch Time in ms
High52	High Price (Trailing 52 Weeks)	Number
High52Date	52 Week High Price Date	Unix Epoch Time in ms
High6M	High Price (Trailing 6 Month)	Number
HighYTD	High Price (Since Jan 1)	Number
HolidayName	Name of holiday, if today is a holiday, or null	String
LastTradeTime	Time of Last Trade	Unix Epoch Time
LessRecentClose	Close Price before Most Recent Close	Number
LessRecentCloseDate	Date of Close Price before Most Recent Close	Unix Epoch Time in ms
Low	Today’s Low Price	Number
Low1M	Low Price (Trailing 1 Month)	Number
Low1MDate	One Month Low Price Date	Unix Epoch Time in ms
Low1W	Low Price (Trailing 1 Week)	Number
Low1WDate	One Week Low Price Date	Unix Epoch Time in ms
Low3M	Low Price (Trailing 3 Month)	Number
Low3MDate	3 Month Low Price Date	Unix Epoch Time in ms
Low52	Low Price (Trailing 52 Weeks)	Number
Low52Date	52 Week Low Price Date	Unix Epoch Time in ms
Low6M	Low Price (Trailing 6 Month)	Number
Low6MDate	6 Month Low Price Date	Unix Epoch Time in ms
LowYTD	Low Price (Since Jan 1)	Number
MostRecentClose	Most Recent Close	Number
MostRecentCloseDate	Most Recent Close Date	Unix Epoch Time in ms
MovingAverage200	Average of Closing Price of last 200 Trading Sessions	Number
MovingAverage50	Average of Closing Price of last 50 Trading Sessions	Number
Name	Security Name	String
Open	Today's Open price	Number
PrevClose	Closing Price from the previous trading day	Number
Price	Latest price for the security	Number
SecurityTypeCode	Code Name of Security Type (e.g., STOCK, FUND)	String
SecurityTypeName	“Pretty” Name of Security Type (e.g., Stock, Fund)	String
ShortName	Short Security Name	String
StartingPrice1M	Starting Price (Trailing 1 Month)	Number
StartingPrice1W	Starting Price (Trailing 1 Week)	Number
StartingPrice3M	Starting Price (Trailing 3 Month)	Number
StartingPrice52	Starting Price (Trailing 52 Weeks)	Number
StartingPrice6M	Starting Price (Trailing 6 Month)	Number
StartingPriceYTD	Starting Price (Since Jan 1)	Number
Symbol	Primary Symbol	String
SymbolID	Symbol Identifier (FinancialContent unique ID)	String
Volume	Today's Cumulative Volume	Number

Use Cases

• 📊 Market Movers Dashboards - Highlight top-performing securities in real time.
  Developers can use the MOSTACTIVE or PERCENTGAINERS lists to populate dynamic dashboards showcasing securities driving market activity. Fields like Price, Volume, and ChangePercent enable engaging visualizations for investors tracking trending stocks or funds.

• 🤖 Algorithmic Trading Triggers - Build systems that react to live market signals.
  Traders can leverage real-time fields like Bid, Ask, and Change to create algorithms that trigger trades based on price movements or volume spikes. This supports automated strategies that capitalize on intraday opportunities in active markets.

• 🔍 Investor Research Tools - Provide insights into trending securities.
  By querying lists like POPULAR or PERCENTLOSERS, analysts can develop tools that highlight securities with significant price movements or high trading activity. Fields like High52 and MovingAverage50 offer context for evaluating investment opportunities.

• 📈 Portfolio Monitoring - Track real-time performance of key securities.
  Portfolio managers can use the API to monitor live metrics like Price and Volume for securities in curated lists, ensuring timely updates on portfolio holdings. This supports real-time decision-making for rebalancing or risk management.

• 🔔 Market Alert Systems - Notify users of significant price or volume changes.
  Developers can build alert systems that use ChangePercent and Volume to notify users of unusual market activity, such as sudden price surges in the PERCENTGAINERS list. This enhances user engagement on trading platforms.

• 🧠 AI-Powered Market Prediction and Sentiment Analysis - Leverage AI to forecast trends and assess market sentiment.
  Data scientists can use fields like ChangePercent, Volume, and MovingAverage50 to train machine learning models that predict future price movements or identify market trends. Additionally, combining real-time data with external sentiment sources (e.g., news or social media) enables AI-driven sentiment analysis to gauge market mood, enhancing predictive accuracy for trading strategies.

Why Choose FinancialContent's getLeaders API?

• 🚀 Unmatched Reliability - Consistent performance during peak trading hours.
  With 99.99% uptime, our fault-tolerant infrastructure ensures uninterrupted access to real-time data, even during volatile market sessions. Developers can trust the API for mission-critical applications like live trading platforms.

• 🔄 Flexible Data Integration - Seamlessly blend real-time and historical insights.
  The API integrates effortlessly with other FinancialContent data feeds, allowing users to combine live market data with historical trends. This is ideal for applications requiring both current performance and long-term context.

• 📈 Scalable Query Handling - Process large lists with no performance lag.
  Built to handle high-volume queries across multiple securities and lists, the API scales efficiently for enterprise-grade applications. Whether querying a handful of stocks or thousands, performance remains robust.

• 📚 Developer-Friendly Resources - Comprehensive support for seamless integration.
  FinancialContent provides detailed documentation, code samples, and dedicated support to ensure smooth onboarding and advanced use. Our team helps developers maximize the API’s potential for any project.

Optimized for High-Speed Access

The getLeaders API is designed for peak performance, adhering to industry best practices for rapid data delivery. Our RESTful endpoints use lightweight JSON formatting to minimize payload size, enabling fast parsing and low bandwidth usage. Advanced caching accelerates repeated queries, while globally distributed servers reduce latency for users worldwide. Rate limiting and pagination ensure stability under high traffic, and asynchronous request handling supports efficient processing of large datasets. This performance-driven design empowers developers to build responsive, real-time applications with minimal delays.

Sample Request

GET /api/getLeaders?T=your_base64_key&list=MOSTACTIVE&type=STOCK&limit=10&calcChange=1&minPrice=5

Sample Response (JSON)

{
  "rows": [
    {
      "Symbol": "AAPL",
      "Name": "Apple Inc.",
      "Price": 150.25,
      "Change": 2.10,
      "ChangePercent": 1.42,
      "Volume": 75000000,
      "Bid": 150.20,
      "Ask": 150.30,
      "High": 151.00,
      "Low": 149.50,
      "Open": 149.75,
      "PrevClose": 148.15,
      "MovingAverage50": 147.80,
      "MovingAverage200": 145.60,
      "ExchangeName": "NASDAQ",
      "SecurityTypeName": "Stock",
      "LastTradeTime": 1730918400000,
      ...
    },
    ...
  ]
}