ETF holdingsPlanned coverage

Reported holdings

etf.holdings.positions

Structured fund positions at their reporting and availability dates.

Planned plan access: Research, Professional
Schema version: 1.2.0
Record key: holding_id, available_at

How to request it

When this dataset appears in your account’s catalog, select its version, supported fields and exact entity identifiers. Set a short date range and an as_of time, then request a small page. The record key identifies a row; it is not necessarily the identifier accepted by the query filter.

HTTP request template

This is a template, not a currently available request. Fill each variable from the authenticated catalog and your intended query. The Explorer can generate a complete request for an available dataset.

GET /v1/data/etf.holdings.positionsHTTP

curl --fail-with-body --get "$ORIGINFOLD_API_URL/v1/data/etf.holdings.positions" \
  --header "Authorization: Bearer $ORIGINFOLD_API_KEY" \
  --data-urlencode "dataset_version=$DATASET_VERSION" \
  --data-urlencode "fields=$FIELDS" \
  --data-urlencode "entity_id=$ENTITY_ID" \
  --data-urlencode "start=$START_DATE" \
  --data-urlencode "end=$END_DATE" \
  --data-urlencode "as_of=$AS_OF" \
  --data-urlencode "limit=25"

See a complete illustrative HTTP and Python example, including what each request parameter means.

Field dictionary

nullable fields may be empty. An empty value is not zero. Types and definitions below come from the dataset schema; the released API may expose only a qualified subset.

Field	Type	Meaning
`dataset_id`	string	Logical dataset identifier.
`version_id`	uuidv7	Immutable origin fragment version identifier; copy-forward manifests retain it without rewriting prior rows.
`schema_version`	semver	Row schema version.
`source_id`	string	Approved official structured source identifier.
`available_at`	timestamp_utc	Earliest documented public source availability; never replaced by report or period time.
`ingested_at`	timestamp_utc	Successful structured acquisition time.
`source_sha256`	sha256	Checksum of the temporary or bounded structured source bytes.
`source_url`	uri	Official provider URL; never a local source-document URL.
`parser_version`	string	Versioned structured parser or method identifier.
`quality_flags`	list[string]	Machine-readable quality and source caveats.
`holding_id`	string	Deterministic public N-PORT position identifier.
`fund_id`	string	Stable MarketWeave fund identifier.
`accession_number`	string	Source N-PORT accession.
`report_period`	date	Portfolio report period; not availability time.
`filing_date`	date	SEC filing date; not availability time.
`acceptance_datetime`	timestamp_utc	SEC acceptance timestamp.
`public_dissemination_at`	timestamp_utc	Earliest documented public dissemination.
`investment_title`	string	Source investment title.
`issuer_name`	string	Source issuer name.
`issuer_lei`	string May be empty	Source LEI when supplied.
`asset_category`	string	Source N-PORT asset category.
`balance`	decimal128_38_12 May be empty	Source position balance; exact SEC NUMBER(36,12) value in decimal128 precision 38, scale 12.
`units`	string May be empty	Source balance unit.
`currency`	string May be empty	Source currency.
`value_usd`	decimal128_38_12 May be empty	Source-reported SEC NUMBER(36,12) USD value in decimal128 precision 38, scale 12.
`percentage_value`	decimal128_38_12 May be empty	Source-reported SEC NUMBER(36,12) portfolio percentage in decimal128 precision 38, scale 12.
`country`	string May be empty	Source country code.
`fair_value_level`	string May be empty	Source fair-value hierarchy level.
`restricted_security`	bool May be empty	Source restricted-security indicator.

Understand observation time, availability and revisions · Limits and errors