Create Assessment

curl --request POST \
  --url https://api.chicago.global/v1/assessment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "system_prompt": "<string>",
  "model": "default",
  "max_tokens": 8000,
  "temperature": 0.4
}
'

import requests

url = "https://api.chicago.global/v1/assessment"

payload = {
    "prompt": "<string>",
    "system_prompt": "<string>",
    "model": "default",
    "max_tokens": 8000,
    "temperature": 0.4
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    system_prompt: '<string>',
    model: 'default',
    max_tokens: 8000,
    temperature: 0.4
  })
};

fetch('https://api.chicago.global/v1/assessment', 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/assessment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'system_prompt' => '<string>',
    'model' => 'default',
    'max_tokens' => 8000,
    'temperature' => 0.4
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.chicago.global/v1/assessment"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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/assessment")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/assessment")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}"

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

{
  "success": true,
  "error": "<string>",
  "timestamp": "<string>",
  "details": "<string>"
}

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

{
  "success": true,
  "error": "<string>",
  "timestamp": "<string>",
  "details": "<string>"
}

Analysis

Create Assessment

Generate an impact assessment report using Perplexity AI (ASYNC - returns job_id immediately).

This endpoint creates a background job for assessment generation. Use GET /jobs/ to check status and retrieve results.

Research Modes:

fast: Uses sonar-pro model (quick web search)
default: Uses sonar-reasoning-pro model (balanced analysis)
deep: Uses sonar-deep-research model (thorough research)

Request Body:

prompt: Full prompt including scenario, portfolio/stock data, and analysis instructions
system_prompt: Optional custom system prompt (defaults to Parallax AI analyst)
model: Research mode - “fast”, “default”, or “deep”
max_tokens: Max response tokens (default 8000)
temperature: Model temperature (default 0.4)

Response Format:

{
    "job_id": "assess-uuid-string",
    "status": "pending",
    "model": "default",
    "check_url": "/v1/jobs/{job_id}",
    "estimated_duration_seconds": 60
}

Result Format (when complete):

{
    "success": true,
    "content": "# Impact Report\n...",
    "search_results": [...],
    "model_used": "sonar-reasoning-pro"
}

Example Prompt:

ANALYSIS TEMPLATE INSTRUCTIONS:
1. Executive Summary (risk/opportunity classification)
2. Direct Impact Analysis by sector
3. Strategic Recommendations

PORTFOLIO CONTEXT:
- Name: Tech Portfolio
- Holdings: AAPL (25%), MSFT (25%), GOOGL (20%)

SCENARIO: What if the Fed raises interest rates by 50 basis points?

POST

assessment

Create Assessment

curl --request POST \
  --url https://api.chicago.global/v1/assessment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "system_prompt": "<string>",
  "model": "default",
  "max_tokens": 8000,
  "temperature": 0.4
}
'

import requests

url = "https://api.chicago.global/v1/assessment"

payload = {
    "prompt": "<string>",
    "system_prompt": "<string>",
    "model": "default",
    "max_tokens": 8000,
    "temperature": 0.4
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    system_prompt: '<string>',
    model: 'default',
    max_tokens: 8000,
    temperature: 0.4
  })
};

fetch('https://api.chicago.global/v1/assessment', 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/assessment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'system_prompt' => '<string>',
    'model' => 'default',
    'max_tokens' => 8000,
    'temperature' => 0.4
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.chicago.global/v1/assessment"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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/assessment")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chicago.global/v1/assessment")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"model\": \"default\",\n  \"max_tokens\": 8000,\n  \"temperature\": 0.4\n}"

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

{
  "success": true,
  "error": "<string>",
  "timestamp": "<string>",
  "details": "<string>"
}

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

{
  "success": true,
  "error": "<string>",
  "timestamp": "<string>",
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

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

Body

application/json

prompt

string

required

Full prompt with scenario, portfolio/stock data, and template instructions

system_prompt

string | null

Custom system prompt (optional)

model

string

default:default

Research mode: 'fast', 'default', or 'deep'

max_tokens

integer

default:8000

Max response tokens

temperature

number

default:0.4

Model temperature (0.0-1.0)

Response

Job created successfully

Last modified on September 21, 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

Create Assessment

Authorizations

Body

Response