Market niches API

Explore research universes and compare certified strategies through their evidence.

GET/api/niches

Explore market niches

A niche groups a research universe by market characteristics or qualifying channel episodes. Browse public niches and their coverage and certification counts.

Parameters

regimestring · query · optional: Target market regime filter.
assetTypestring · query · optional: Asset-type filter.
countrystring · query · optional: Country-code filter.
exchangestring · query · optional: Exchange filter.
limitinteger · query · optional: Positive whole number, up to nine digits. Defaults to 200; values above 500 are capped at 500. Zero, negative, decimal and repeated values are rejected.

Behaviour and limits

Use a non-null nicheKey from the response to request niche detail.
Null metrics mean data has not been computed or does not apply; they are not zero.
No cursor or page parameter is supported. Filters narrow the returned collection.

Error responses

400: invalid_niche_filter
500: failed_to_fetch_niches

Validation may also return a general request error. See error handling and rate limits.

Explore market niches · cURL

curl --fail-with-body 'https://api.weavers.app/api/niches?limit=5'

Explore market niches · JavaScript

const response = await fetch("https://api.weavers.app/api/niches?limit=5", {
  signal: AbortSignal.timeout(15000),
});
if (!response.ok) {
  throw new Error(`Weavers API returned ${response.status}`);
}
const data = await response.json();
console.log(data);

Explore market niches · Python

import json
from urllib.request import urlopen

with urlopen("https://api.weavers.app/api/niches?limit=5", timeout=15) as response:
    data = json.load(response)
print(data)

200 · Illustrative response

{
  "niches": [
    {
      "nicheId": 1,
      "nicheKey": "example-niche",
      "displayName": "Example research niche",
      "source": "platform",
      "visibility": "public",
      "membershipKind": "static",
      "targetRegime": null,
      "assetType": "ETF",
      "countryCode": "US",
      "exchange": null,
      "certifiedCount": 0,
      "liveCount": 0,
      "medianDailyDollarVolume": null,
      "realizedVolatility": null,
      "crossSectionalDispersion": null,
      "historyDepthDays": null,
      "pricedConstituentCount": null,
      "metricsAsOfDate": null
    }
  ]
}

Example data is illustrative. Additional response fields may be present. Empty lists are valid responses.

Response fields

Core response fields. Nested evidence payloads may include additional fields.
Field	Type	Meaning
`niches`	`object[]`	See the nested fields below.
`niches[].nicheId`	`integer`	Niche identifier.
`niches[].nicheKey`	`string \| null`	Public detail key; may be null for older entries.
`niches[].displayName`	`string`	Niche name.
`niches[].source`	`string`	Origin of the niche definition.
`niches[].visibility`	`string`	Only public niches are returned.
`niches[].targetRegime`	`string \| null`	Target market regime; may be null for channel episodes.
`niches[].membershipKind`	`string`	Static universe or membership during qualifying channel episodes.
`niches[].assetType`	`string \| null`	Asset class.
`niches[].countryCode`	`string \| null`	Country code.
`niches[].exchange`	`string \| null`	Exchange.
`niches[].certifiedCount`	`integer`	Number of certified members.
`niches[].liveCount`	`integer`	Number of live members.
`niches[].medianDailyDollarVolume`	`number \| null`	Median daily dollar volume when computed.
`niches[].realizedVolatility`	`number \| null`	Stored realized-volatility metric. Interpret with its research context.
`niches[].crossSectionalDispersion`	`number \| null`	Stored cross-sectional dispersion metric.
`niches[].historyDepthDays`	`integer \| null`	Available history in days.
`niches[].pricedConstituentCount`	`integer \| null`	Constituents with prices.
`niches[].metricsAsOfDate`	`string \| null`	Calendar date in YYYY-MM-DD format.

GET/api/niches/{nicheKey}

Inspect a niche's certified set

Read a public niche's research context and its certified strategies, with evidence, disclosures and limitations alongside each strategy.