Assets

List Assets

Screen the catalog. Structured filters AND together with q (ticker or full text). tags matches any of its values, tags_all requires every one, tags_none excludes any of them; all accept only the closed vocabulary, which include=facets returns by dimension. country is the single country named by the fund (germany, japan, …); a broader region does not match. price_coverage separates a catalog seed from stored bars, and tax_evidence is unclassified when tax form and legal structure are null. min_market_cap is a size floor on market cap or fund AUM. Sort by symbol, name, aum, expense_ratio, leverage or first_price_date.

get/v1/assets

Request

  • Base URL: https://api.ensemble.markets (the document declares no server; this is the origin it was published from)
  • URL: https://api.ensemble.markets/v1/assets
  • Auth: HTTP bearer

Query parameters

includestring[] nullable

facets: counts for the current filter set and the closed tag vocabulary

limitinteger

Rows per page

offsetinteger

Rows to skip

qstring nullable

Ticker or full-text search, composed with structured filters

typestring nullable

Asset type: etf | fund | stock | crypto

exchangestring nullable

Listing exchange code, e.g. US

sectorstring nullable

Stock sector (legacy data blob)

min_market_capinteger nullable

Minimum market cap or fund AUM, in USD

delistedboolean

Include delisted assets

tax_formstring nullable

1099 | k1 | pfic (NULL excluded)

legal_structurestring nullable

ric | uit | grantor_trust | commodity_pool | etn | closed_end_trust

asset_classstring nullable

equity | fixed_income | commodity | currency | alternatives | asset_allocation

tagsstring[] nullable

Match ANY of these tags. Descriptive dimension:value tags, repeatable or comma-separated (sector:energy, commodity:precious_metals, theme:gold_miners, region:us, size:large, bond:high_yield). An unrecognized tag is a 422.

tags_allstring[] nullable

Require ALL of these tags. Descriptive dimension:value tags, repeatable or comma-separated (sector:energy, commodity:precious_metals, theme:gold_miners, region:us, size:large, bond:high_yield). An unrecognized tag is a 422.

tags_nonestring[] nullable

Exclude assets carrying ANY of these tags; untagged assets pass. Descriptive dimension:value tags, repeatable or comma-separated (sector:energy, commodity:precious_metals, theme:gold_miners, region:us, size:large, bond:high_yield). An unrecognized tag is a 422.

leverage_minnumber nullable

Signed leverage lower bound (inclusive)

leverage_maxnumber nullable

Signed leverage upper bound (inclusive)

issuerstring nullable

Issuer / fund family prefix (case-insensitive)

max_first_price_datestring date nullable

Require first_price_date on or before this day (history depth)

countrystring nullable

Single-country mandate read from the fund name. argentina, australia, austria, belgium, brazil, canada, chile, china, colombia, denmark, finland, france, germany, greece, hong_kong, iceland, india, indonesia, ireland, israel, italy, japan, kuwait, malaysia, mexico, netherlands, new_zealand, norway, philippines, poland, qatar, saudi_arabia, singapore, south_africa, south_korea, spain, sweden, switzerland, taiwan, thailand, turkey, united_arab_emirates, united_kingdom, vietnam. A broader region, a second country, or an unrecognized value does not match. Holdings are not consulted.

sortstring nullable

symbol | name | aum | expense_ratio | leverage | first_price_date

orderstring nullable

asc | desc

Response

Successful Response

totalinteger required

Assets matching the filters, across every page

Changes

No recorded changes to this operation across all 1 revision of this API.