Skip to main content
POST
Peers Analysis
Generate an AI-powered peer comparison analysis for a stock. Compares the company against its sector peers on valuation, performance, and fundamentals.

How It Works

This endpoint uses async job processing:
  1. Submit Request: POST with a stock symbol
  2. Receive Job ID: Get a job ID and polling URL immediately
  3. Poll for Status: Check /v1/jobs/{job_id} until status is completed
  4. Get Analysis: The completed job contains a narrative peer comparison
Analysis typically takes 30-60 seconds.

Query Parameters

Response (202 Accepted)

Completed Response

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

Result Fields

Example

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 April 1, 2026