Financial Analysis

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.post("https://api.chicago.global/v1/financial-analysis")
  .header("Authorization", "Bearer <token>")
  .asString();

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

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

{
  "detail": "<string>"
}

POST

financial-analysis

Financial Analysis

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.post("https://api.chicago.global/v1/financial-analysis")
  .header("Authorization", "Bearer <token>")
  .asString();

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

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

{
  "detail": "<string>"
}

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

API key passed as Bearer token

Query Parameters

symbol

string

required

Stock symbol (e.g., AAPL.O for Apple Inc)

Response

Job created successfully. Poll the check_url for results.

job_id

string

Unique job identifier

status

enum<string>

Initial job status

Available options:

pending

symbol

string

Stock symbol being analyzed

check_url

string

URL to poll for job status

estimated_duration_seconds

integer

Estimated processing time in seconds

message

string

Human-readable status message

Generate Stock Report Technical 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