> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chicago.global/llms.txt
> Use this file to discover all available pages before exploring further.
# Financial Analysis
> Get comprehensive AI-powered financial analysis including business strategy, accounting quality, financial performance, and investment recommendation. Analysis typically takes 2-5 minutes.
## How It Works
This endpoint uses **async job processing** for AI-powered financial analysis:
1. **Submit Request**: POST with stock symbol as query parameter
2. **Receive Job ID**: Get a job ID and polling URL immediately
3. **Poll for Status**: Check `/v1/jobs/{job_id}` until status is `completed`
4. **Get Analysis**: The completed job contains comprehensive financial analysis
Analysis typically takes 2-5 minutes. Provides comprehensive business strategy, accounting quality, and financial performance analysis.
## Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------------- |
| `symbol` | string | Yes | Stock symbol (e.g., AAPL.O for Apple Inc) |
## Response (202 Accepted)
```json theme={null}
{
"job_id": "fin-a3522a92-87ed-4be0-a912-ad56ed6a8806",
"status": "pending",
"symbol": "AAPL.O",
"check_url": "/v1/jobs/fin-a3522a92-87ed-4be0-a912-ad56ed6a8806",
"estimated_duration_seconds": 180,
"message": "Financial analysis started for AAPL.O."
}
```
## Completed Response
When the job completes, `GET /v1/jobs/{job_id}` returns:
```json theme={null}
{
"job_id": "fin-a3522a92-87ed-4be0-a912-ad56ed6a8806",
"job_type": "financial_analysis",
"status": "completed",
"result": {
"symbol": "AAPL.O",
"executiveSummary": {
"investmentThesis": "Apple remains a dominant consumer technology franchise...",
"keyHighlights": [
"ROE of 147% driven by exceptional asset efficiency...",
"Services segment growing at 15% CAGR provides recurring revenue...",
"Net cash position of $51B provides strategic flexibility..."
],
"recommendedAction": "BUY",
"confidenceLevel": "HIGH",
"targetPriceRange": "$195-220 based on DCF and comparable analysis"
},
"detailedAnalysis": {
"businessStrategy": {
"industryPosition": "Market leader in premium smartphones and wearables...",
"competitiveAdvantage": "Ecosystem lock-in, brand loyalty, vertical integration...",
"businessModel": "Hardware + Services model with high switching costs...",
"keyRisks": ["China exposure", "Regulatory scrutiny", "Innovation cycles"]
},
"accountingQuality": {
"earningsQuality": "HIGH",
"conservatismLevel": "Conservative revenue recognition policies...",
"keyPolicies": ["Revenue recognized at point of sale..."],
"accountingRedFlags": []
},
"financialPerformance": {
"profitabilityAnalysis": {
"roeDecomposition": "ROE of 147% = 25% margin × 1.1x turnover × 5.4x leverage",
"marginAnalysis": "Gross margin stable at 43-44%...",
"profitabilityTrends": "Consistent margin expansion over 3 years..."
},
"liquidityAssessment": {
"shortTermLiquidity": "Current ratio of 1.0x, quick ratio 0.9x...",
"workingCapitalAnalysis": "Negative working capital driven by payables...",
"cashFlowQuality": "Strong FCF conversion of 95%..."
},
"solvencyAnalysis": {
"debtLevel": "Net debt/EBITDA of 0.5x...",
"coverageRatios": "Interest coverage >30x...",
"financialFlexibility": "High flexibility with $51B net cash..."
},
"efficiencyMetrics": {
"assetUtilization": "Asset turnover of 1.1x...",
"operationalEfficiency": "Inventory days of 9, best in class...",
"managementEffectiveness": "High ROIC of 56%..."
}
},
"prospectiveAnalysis": {
"growthProspects": "Mid-single digit revenue growth expected...",
"futureEarnings": "EPS growth of 8-10% driven by buybacks...",
"valuationAssessment": "Trading at 28x forward P/E vs 5yr avg 25x...",
"scenarioAnalysis": [
"Bull: Services acceleration drives 15% upside",
"Base: Steady growth, 8% return expected",
"Bear: China slowdown, 15% downside risk"
]
}
}
}
}
```
Results are cached for 14 days. Subsequent requests for the same symbol will return cached analysis instantly.
## Analysis Framework
The analysis covers the following areas:
| Section | Description |
| ------------------------- | -------------------------------------------------- |
| **Executive Summary** | Investment thesis, recommendation, target price |
| **Business Strategy** | Competitive position, moats, business model, risks |
| **Accounting Quality** | Earnings quality, red flags, policy assessment |
| **Financial Performance** | Profitability, liquidity, solvency, efficiency |
| **Prospective Analysis** | Growth prospects, scenarios, valuation |
## Example: Polling for Results
```javascript theme={null}
const response = await fetch(
'https://api.chicago.global/v1/financial-analysis?symbol=AAPL.O',
{
method: 'POST',
headers: { 'Authorization': `Bearer ${API_KEY}` }
}
);
const { job_id } = await response.json();
// Poll every 10 seconds
const interval = setInterval(async () => {
const status = await fetch(
`https://api.chicago.global/v1/jobs/${job_id}`,
{ headers: { 'Authorization': `Bearer ${API_KEY}` } }
).then(r => r.json());
if (status.status === 'completed') {
clearInterval(interval);
console.log('Recommendation:', status.result.executiveSummary.recommendedAction);
console.log('Thesis:', status.result.executiveSummary.investmentThesis);
} else if (status.status === 'failed') {
clearInterval(interval);
console.error('Failed:', status.error);
}
}, 10000);
```
## OpenAPI
````yaml POST /v1/financial-analysis
openapi: 3.1.0
info:
title: Parallax API
description: >-
Financial data and portfolio analytics API. Analyze portfolios with
multi-currency support, rebalancing, and comprehensive metrics.
version: 1.0.0
servers:
- url: https://api.chicago.global
security:
- bearerAuth: []
paths:
/v1/financial-analysis:
post:
tags:
- Analysis
summary: Financial Analysis
description: >-
Get comprehensive AI-powered financial analysis including business
strategy, accounting quality, financial performance, and investment
recommendation. Analysis typically takes 2-5 minutes.
operationId: financialAnalysis
parameters:
- name: symbol
in: query
required: true
description: Stock symbol (e.g., AAPL.O for Apple Inc)
schema:
type: string
example: AAPL.O
responses:
'202':
description: Job created successfully. Poll the check_url for results.
content:
application/json:
schema:
$ref: '#/components/schemas/FinancialAnalysisJobResponse'
example:
job_id: fin-a3522a92-87ed-4be0-a912-ad56ed6a8806
status: pending
symbol: AAPL.O
check_url: /v1/jobs/fin-a3522a92-87ed-4be0-a912-ad56ed6a8806
estimated_duration_seconds: 180
message: Financial analysis started for AAPL.O.
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
FinancialAnalysisJobResponse:
type: object
properties:
job_id:
type: string
description: Unique job identifier
status:
type: string
enum:
- pending
description: Initial job status
symbol:
type: string
description: Stock symbol being analyzed
check_url:
type: string
description: URL to poll for job status
estimated_duration_seconds:
type: integer
description: Estimated processing time in seconds
message:
type: string
description: Human-readable status message
Error:
type: object
properties:
detail:
type: string
description: Error message
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key passed as Bearer token
````