Skip to main content
GET
List result companies for a run

Authorizations

Authorization
string
header
required

Enter 'Bearer' followed by a space and then your JWT or API Key. Example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... or Bearer YOUR_API_KEY_HERE

Path Parameters

strategyId
string<uuid>
required

UUID of the strategy.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Query Parameters

asOfDate
string<date>

The as-of date in YYYY-MM-DD format that selects a specific run of the version. When omitted, the latest completed run for the version is used.

Pattern: ^\d{4}-\d{2}-\d{2}$
versionId
string<uuid>

The version to read. When omitted, the strategy's active version is used.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
includeReasoning
boolean
default:false

When true, includes the reasoning text for each company.

scoringMinMarketCap
number
default:500000000

No longer applied. The conviction score is computed from linguistic beta and market buzz alone, with no market-cap eligibility floor — every company in the universe receives a score. Accepted for backwards compatibility and ignored.

exchangeRegion
string[]

Values that pick which of a company's listings represents it. A run records one listing per company (US-major first), so this is what surfaces the European or Asian line instead. Each value is a Region label or an ISO 10383 MIC. A company with no matching listing is omitted from the response. Supplying this parameter overrides the strategy's stored filter_intent, so ?exchangeRegion= is how a caller asks for no exchange-region filter at all rather than the stored one.

domicile
string[]

Domicile: the country of incorporation, or for an issuer incorporated in an offshore centre the country of its best ordinary-share listing. Each value is a Region label or an ISO 3166-1 alpha-2 code. A company whose domicile matches none of them is omitted. Supplying this parameter overrides the strategy's stored filter_intent, so ?domicile= is how a caller asks for no domicile filter rather than the stored one.

marketCapMin
number

Inclusive lower bound, in USD, on the market cap the run recorded for each company. A company with no recorded market cap is omitted whenever either bound is supplied. A run that recorded no market cap at all, such as a historical run dated before 2025-01-01, ignores the bounds. Supplying this parameter overrides the strategy's stored filter_intent.

Required range: x >= 0
marketCapMax
number

Inclusive upper bound in USD. See marketCapMin.

Required range: x >= 0

Response

The list of companies, empty when the run produced none.

id
string<uuid>
required
symbol
string
required
Example:

"TSLA"

name
string
required
Example:

"Tesla, Inc."

isin
string | null
required
exchange
string
required
Example:

"NASDAQ"

market
string | null
required
sector
string | null
required
industry
string | null
required
marketCap
number | null
required
volAvg
number<float> | null
required
linguisticBeta
number<float>
required
marketBuzz
number<float>
required

Share of the strategy's total market buzz, over the companies in the response.

active
boolean
required

Whether the company is currently active.

figi
string | null

Bloomberg Financial Instrument Global Identifier (FIGI) for the listing.

domicile
string | null

Domicile as of the run date, as a display name: the country of incorporation, or for an issuer incorporated in an offshore centre the country of its best ordinary-share listing. Present in the companies reads; omitted from optimized portfolios.

Example:

"Cayman Islands"

domicileCode
string | null

ISO 3166-1 alpha-2 domicile as of the run date.

Example:

"KY"

mic
string | null

ISO 10383 operating market identifier code for the listing exchange.

reasoning
string | null

Why the company was included. Present only when includeReasoning is true.

convictionScore
number<float> | null

Conviction score between 0 and 1 that combines market buzz and linguistic beta. A higher score indicates a stronger thematic signal on both dimensions, relative to the companies in the response.