Financial Analysis

curl --request POST \
  --url https://api.chicago.global/v1/financial-analysis \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.chicago.global/v1/financial-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chicago.global/v1/financial-analysis",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chicago.global/v1/financial-analysis"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/financial-analysis")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

POST

financial-analysis

Financial Analysis

curl --request POST \
  --url https://api.chicago.global/v1/financial-analysis \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.chicago.global/v1/financial-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.chicago.global/v1/financial-analysis",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.chicago.global/v1/financial-analysis"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/financial-analysis")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

How It Works

This endpoint uses async job processing for AI-powered financial analysis:

Submit Request: POST with stock symbol as query parameter
Receive Job ID: Get a job ID and polling URL immediately
Poll for Status: Check /v1/jobs/{job_id} until status is completed
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)

{
  "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:

{
  "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

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);

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

symbol

string

required

Stock symbol(s). Single or comma-separated

Examples:

"AAPL"

"AAPL,MSFT,GOOG"

Response

Successful Response

Last modified on January 20, 2026

Overview

Portfolio Analysis

Portfolio Tracker

Builder

Stock

Analysis

News

Company Data

Financial Statements

Financial Ratios

Financial Data

Scores

Valuation

Price Data

ETF

Macro Reports

Telemetry

Validation

Financial Analysis

How It Works

Query Parameters

Response (202 Accepted)

Completed Response

Analysis Framework

Example: Polling for Results

Authorizations

Query Parameters

Response

​How It Works

​Query Parameters

​Response (202 Accepted)

​Completed Response

​Analysis Framework

​Example: Polling for Results

Authorizations

Query Parameters

Response

How It Works

Query Parameters

Response (202 Accepted)

Completed Response

Analysis Framework

Example: Polling for Results