ASasksurf
Equity

ETF Holdings

Returns a stored ETF or index-fund portfolio snapshot plus its immediately previous snapshot, ordered newest to oldest. Available quarterly periods describe the stored holdings history. The latest pair is cached for 6 hours; an explicit historical as_of pair is cached until the next calendar quarter.

get/gateway/v1/equity/etf/holdings

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

symbolstring required

US-listed ETF or index-fund ticker symbol

Example:SPY
as_ofstring

Select the composition effective on or before this YYYY-MM-DD date; the response also includes its immediately previous snapshot

Example:2026-03-31
asset_class'equity' | 'bond'

Filter holdings by instrument type

limitinteger

Maximum holdings to return

offsetinteger

Number of holdings to skip

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseEquityETFHoldingsResponse.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.