Access Dividend and Split Adjusted Monthly Returns

This API is designed for developers building tools for a wide range of financial applications, including portfolio performance tracking, historical trend analysis, financial reporting, benchmarking against market indices, and quantitative model development. It also supports advanced AI-driven use cases, such as training machine learning models to predict stock price movements based on historical return patterns and generating investment insights for automated advisory platforms.

Key Features

• 📅 Monthly Adjusted Price Data - Retrieve dividend and split adjusted closing prices by month.
  Users can access monthly aggregated data, including adjusted closing prices for the last trading day of each month, ideal for tracking long-term performance. This feature simplifies integration into tools like portfolio trackers or historical performance charts, ensuring accurate data for financial analysis.

• 📈 Return Percentage Calculations - Get pre-calculated monthly return percentages.
  The API provides the returnPercent field, which measures the percentage change in adjusted closing price compared to the previous month. This allows analysts to quickly assess month-over-month performance without manual calculations, perfect for performance reporting or trend analysis.

• 🔍 Support for Individual Symbols - Query monthly data for a single stock or security.
  By specifying a single ticker symbol (e.g., GOOG), users can retrieve focused datasets for specific securities, streamlining workflows for investors or researchers analyzing individual stocks. This targeted approach enhances efficiency in applications like stock comparison tools.

• 🔐 Secure Authentication - Access data with a Base64-encoded application key.
  The API requires a T parameter for authentication, ensuring secure access to monthly return data. This feature enables developers to confidently integrate the API into production environments, protecting sensitive financial applications from unauthorized access.

Available Data Fields

Each API call returns a collection of monthly stock data with the following columns. Always reference the columns array when parsing to ensure correct data mapping, as column order may vary.

Name	Meaning	Data Type
year	Year	Number
month	Month	Number
finalDay	Final Trading Day of Month	Number
adjustedClosingPrice	Adjusted Closing Price as of the last day of trading	Double
returnPercent	Percent Change of the last day of trading compared to the previous month	Double

Query Parameters

The API accepts the following parameters to customize your request:

Parameter	Meaning	Data Type
T	Application Key which authenticates you with CloudQuote (required)	Base64 String
symbol	One symbol to look up (e.g., GOOG)	String

Use Cases

• 📊 Portfolio Performance Tracking - Monitor monthly returns for investment portfolios.
  Analysts can use the adjusted closing prices and return percentages to evaluate portfolio performance over time, enabling clear comparisons across securities. This supports applications like portfolio management dashboards that display long-term trends.

• 📈 Historical Trend Analysis - Identify long-term price and return patterns.
  Researchers can leverage monthly data to study historical performance trends, using fields like returnPercent to spot growth or decline patterns. This is ideal for tools that help investors identify stable or high-growth stocks.

• 🧠 Financial Reporting Tools - Generate accurate monthly performance reports.
  Developers can integrate the API to populate financial reports with adjusted closing prices and return percentages, streamlining the creation of investor-facing documents. This ensures compliance-ready data for fund managers or financial advisors.

• 🔍 Benchmarking and Comparison - Compare stock performance against market benchmarks.
  By querying monthly return data for individual securities, analysts can compare performance against indices or peers, using adjustedClosingPrice for precise metrics. This supports strategic decision-making in asset allocation.

• 🤖 Quantitative Model Development - Feed monthly returns into quantitative models.
  Data scientists can use the API’s return percentages and adjusted prices to build models for forecasting or risk analysis, leveraging clean, pre-calculated data to enhance model accuracy in applications like algorithmic trading.

Why Choose FinancialContent's getMonthlyReturns API?

• 🚀 Unmatched Reliability - Consistent access with enterprise-grade uptime.
  Built on a robust infrastructure, the API ensures 99.99% uptime, delivering reliable data even during high-demand periods. This makes it a trusted choice for mission-critical financial applications.

• 🔄 Seamless Data Integration - Combine monthly returns with other data feeds.
  The API supports integration with FinancialContent’s other data services, allowing users to blend monthly returns with intraday or historical data for comprehensive analysis. This is ideal for applications requiring multi-dimensional market insights.

• 📈 Scalable for Any Workload - Handle queries for any stock with ease.
  Designed to process requests for individual symbols across extensive historical periods, the API scales efficiently to meet the needs of both small fintech apps and large-scale financial platforms.

• 📚 Developer-First Support - Robust documentation and expert guidance.
  FinancialContent provides comprehensive API documentation, sample code, and responsive support to ensure smooth integration. From setup to advanced use cases, our team helps developers unlock the API’s full potential.

Optimized for High-Speed Access

The getMonthlyReturns API is engineered for top-tier performance, adhering to industry best practices for efficient data delivery. Our RESTful endpoints use compact JSON formatting to minimize payload size, enabling fast parsing and reduced bandwidth usage. Advanced caching accelerates repeated queries, while globally distributed servers ensure low-latency responses for users worldwide. Rate limiting and pagination maintain stability under heavy loads, and asynchronous request handling supports seamless processing of large datasets. This performance-driven design ensures developers can build responsive applications with minimal delays.

Sample Request

GET /api/getMonthlyReturns?T=your_base64_key&symbol=GOOG

Sample Response (JSON)

{
  "columns": ["year", "month", "finalDay", "adjustedClosingPrice", "returnPercent"],
  "rows": [
    [2025, 6, 30, 2500.75, 2.15],
    [2025, 7, 31, 2550.20, 1.98],
    ...
  ]
}