Technical Analysis

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

import requests

url = "https://api.chicago.global/v1/technical-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/technical-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/technical-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/technical-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/technical-analysis")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/technical-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": "tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "status": "pending",
  "symbol": "AAPL.O",
  "force": false,
  "check_url": "/v1/jobs/tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "estimated_duration_seconds": 30,
  "message": "Technical analysis started for AAPL.O."
}

{
  "detail": "<string>"
}

POST

technical-analysis

Technical Analysis

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

import requests

url = "https://api.chicago.global/v1/technical-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/technical-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/technical-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/technical-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/technical-analysis")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/technical-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": "tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "status": "pending",
  "symbol": "AAPL.O",
  "force": false,
  "check_url": "/v1/jobs/tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "estimated_duration_seconds": 30,
  "message": "Technical analysis started for AAPL.O."
}

{
  "detail": "<string>"
}

How It Works

This endpoint uses async job processing for AI-powered technical 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 technical analysis

Analysis typically takes 15-30 seconds. Results are cached daily - subsequent requests return cached analysis instantly.

Query Parameters

Parameter	Type	Required	Default	Description
`symbol`	string	Yes	-	Stock symbol (e.g., AAPL.O for Apple Inc)
`force`	boolean	No	`false`	Force regeneration even if cached analysis exists

If force is false and analysis was generated today, the cached result will be returned.

Response (202 Accepted)

{
  "job_id": "tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "status": "pending",
  "symbol": "AAPL.O",
  "force": false,
  "check_url": "/v1/jobs/tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "estimated_duration_seconds": 30,
  "message": "Technical analysis started for AAPL.O."
}

Completed Response

When the job completes, GET /v1/jobs/{job_id} returns:

{
  "job_id": "tech-a3522a92-87ed-4be0-a912-ad56ed6a8806",
  "job_type": "technical_analysis",
  "status": "completed",
  "result": {
    "symbol": "AAPL.O",
    "executive_summary": "AAPL trading at $178.52, down 1.2% from 5-day high. RSI at 52 (neutral), MACD showing bearish crossover. Short-term consolidation within broader uptrend.",

    "technical_analysis": {
      "trend_analysis": "Price 2.3% above SMA50 ($174.52) and 8.1% above SMA200 ($165.12). 30-day trend bullish with higher lows.",

      "momentum_indicators": "RSI at 52.3 (neutral zone). MACD histogram negative at -0.42, signal line crossover occurred 2 days ago indicating short-term weakness.",

      "price_action": "Trading between support at $175.20 (1.9% below) and resistance at $182.50 (2.2% above). Key breakout level at $183.",

      "volume_analysis": "Volume at 0.85x 30-day average. Declining volume on recent pullback suggests lack of selling conviction.",

      "volatility_assessment": "ATR at 2.1% of price. Trading in middle of Bollinger Bands, indicating normal volatility conditions."
    },

    "risk_assessment": {
      "volatility_level": "Moderate volatility with 2.1% daily ATR, typical for large-cap tech.",
      "risk_factors": "Key stop level at $174.50 (SMA50). Watch for breakdown below $172 which would signal trend reversal."
    }
  }
}

Response Fields

Field	Description
`executive_summary`	2-3 sentence overview with price, key indicators, and directional bias
`technical_analysis.trend_analysis`	Price vs moving averages, trend direction
`technical_analysis.momentum_indicators`	RSI, MACD readings and interpretation
`technical_analysis.price_action`	Support/resistance levels, key price zones
`technical_analysis.volume_analysis`	Volume patterns and implications
`technical_analysis.volatility_assessment`	ATR, Bollinger Bands, volatility level
`risk_assessment.volatility_level`	Volatility classification
`risk_assessment.risk_factors`	Key risk levels and stop-loss guidance

Example: Polling for Results

const response = await fetch(
  'https://api.chicago.global/v1/technical-analysis?symbol=AAPL.O',
  {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  }
);

const { job_id } = await response.json();

// Poll every 5 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('Summary:', status.result.executive_summary);
    console.log('Trend:', status.result.technical_analysis.trend_analysis);
  } else if (status.status === 'failed') {
    clearInterval(interval);
    console.error('Failed:', status.error);
  }
}, 5000);

Error Responses

Status	Description
401	Invalid or missing API key
500	Failed to create job

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)

force

boolean

default:false

Force regeneration even if cached analysis exists

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

force

boolean

Whether force regeneration was requested

check_url

string

URL to poll for job status

estimated_duration_seconds

integer

Estimated processing time in seconds

message

string

Human-readable status message

Financial Analysis Score Analysis

​How It Works

​Query Parameters

​Response (202 Accepted)

​Completed Response

​Response Fields

​Example: Polling for Results

​Error Responses

Authorizations

Query Parameters

Response

How It Works

Query Parameters

Response (202 Accepted)

Completed Response

Response Fields

Example: Polling for Results

Error Responses