Parallax API Overview

The Parallax API gives you programmatic access to Chicago Global’s investment intelligence: multi-factor scoring, portfolio analysis and tracking, financial statements, analyst estimates, ETF analytics, valuation (DCF & multiples), macro and market telemetry, and AI-generated research reports.

Base URL

All API requests should be made to:

https://api.chicago.global

The current API version is v1.1.0. The URL path version (/v1/) is a separate, slower-moving axis — see the changelog for the release history and our SemVer policy.

Authentication

All /v1/* endpoints require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API key secure. Do not expose it in client-side code or public repositories. Contact parallax@chicago.global to request a key.

Prefer using the tools directly from an AI client? The same intelligence is available over the Parallax MCP server with browser-based OAuth sign-in and client-managed access tokens.

Symbol format

Most endpoints accept a symbol in RIC format — the ticker plus an exchange suffix, e.g. AAPL.O (Apple, Nasdaq), JPM.N (JPMorgan, NYSE), RELI.NS (Reliance, NSE), 2330.TW (TSMC, Taiwan). Plain tickers are accepted by some endpoints and by /v1/validate-symbol, but RIC is the canonical form. Use Stock Search or Validate Symbol to resolve a RIC.

Async job processing

Long-running endpoints (portfolio analysis, stock reports, technical/financial/news analysis, CIO reports, assessments, company background, macro context) use an async job pattern:

Submit — POST your request to the endpoint.
Receive a job — you get a job_id (and a polling URL) immediately.
Poll — GET /v1/jobs/{job_id} until status is completed (or failed).
Read results — the completed response contains your data.

// 1. Submit
const { job_id } = await fetch('https://api.chicago.global/v1/portfolio/analyze', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
}).then(r => r.json());

// 2. Poll
let result;
while (!result) {
  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') result = status.result;
  else if (status.status === 'failed') throw new Error(status.error);
  else await new Promise(r => setTimeout(r, 3000));
}

Use List Jobs to enumerate recent jobs, and Get Job Status to poll a single job.

Response headers

Header	Description
`X-Request-ID`	Unique ID for the request. Include it when reporting an issue so we can trace it.
`X-Credits-Remaining`	Credits left on your key after a billable request (when applicable).

Response codes

Code	Description
200	Success
401	Unauthorized — invalid or missing API key
404	Not found
422	Validation error — check the request body
429	Rate limit exceeded — slow down and retry
500	Server error — includes an `X-Request-ID` you can report

Rate limits

Requests are rate limited per API key. If you exceed your limit you’ll receive a 429 response; back off and retry. Limits depend on your plan — contact support for details.

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

Base URL

Authentication

Symbol format

Async job processing

Response headers

Response codes

Rate limits

​Base URL

​Authentication

​Symbol format

​Async job processing

​Response headers

​Response codes

​Rate limits

Base URL

Authentication

Symbol format

Async job processing

Response headers

Response codes

Rate limits