Skip to main content
GET
List companies in a premade strategy

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
required

UUID of the user strategy

Query Parameters

includeReasoning
boolean
default:false

When true, include 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

200 - application/json

Array of companies

id
string<uuid>
required
Example:

"b544d95b-43a6-4a50-a326-90552b05c551"

symbol
string
required
Example:

"TSLA"

name
string
required
Example:

"Tesla, Inc."

isin
string | null
required
Example:

"US88160R1014"

exchange
string
required
Example:

"NASDAQ"

market
string | null
required
Example:

"us"

sector
string | null
required
Example:

"Consumer Cyclical"

industry
string | null
required
Example:

"Auto - Manufacturers"

marketCap
number | null
required
Example:

902298200000

volAvg
number<float> | null
required
Example:

1250000

linguisticBeta
number<float>
required
Example:

0.12002

marketBuzz
number<float>
required

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

Example:

0.406

active
boolean
required

Whether the company is currently active.

Example:

true

figi
string | null

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

Example:

"BBG000N9MNX3"

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 and historical-data 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.

Example:

"XNAS"

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.

Example:

0.75