Index funds

Get ETF / index-fund holdings

Returns an ETF or index fund’s current holdings and each position’s weight, resolved via a live web search plus a scrape of the fund’s public holdings fact sheet (Context.dev /web/search and /web/scrape/markdown) - not an SEC filing feed - see go/service/indexfund.go. Only ticker mode is supported: Financial Datasets’ reverse “?holding=AAPL” lookup (funds holding a given security) is not implemented by get_index_fund, so ticker is required regardless of what other query parameters are set (missing ticker answers a real HTTP 400). Pagination is offset/limit (not the cursor scheme this API’s other list routes use), applied to the holdings already resolved for this call. If the routable holdings document could not be parsed at all, this server answers HTTP 200 with a bad_request ErrorResponse body (“holdings document not routable for TICKER”) rather than fabricating an empty holdings list.

GET

index-funds

curl --request GET \
  --url https://financialdatasets.rip/index-funds \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/index-funds', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/index-funds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/index-funds"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/index-funds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "ticker": "SPY",
  "fund": {
    "name": "Example S&P 500 ETF Trust",
    "as_of": "2025-08-31",
    "source": "public fund holdings fact sheet (markdown)",
    "total_holdings": 503,
    "returned": 1,
    "offset": 0
  },
  "holdings": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "weight": 7.05,
      "market_value": 21000000000,
      "shares": 165000000,
      "asset_class": "equity"
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

required

The fund's ticker symbol (e.g., SPY, QQQ, VTI). Uppercase-normalized, 1-20 letters/digits/dots/hyphens.

as_of

string<date>

Return the fund composition in effect on or before this date (YYYY-MM-DD). Without it, this server returns whatever the routable fact sheet currently reports. If the routable fact sheet is dated after as_of, this server answers HTTP 200 with a not_found ErrorResponse body instead of guessing an earlier composition.

asset_class

enum<string>

Restrict holdings to equity or bond instruments. Omit to return every holding the fact sheet lists.

Available options:

equity,

bond

limit

integer

default:50

Number of records to retrieve (default: 50, max: 1000). Maximum number of holdings in this page.

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of holdings to skip before this page starts, for paging through a large holdings list (default 0).

Required range: x >= 0

Response

Illustrative shape (no captured live sample committed for this route); values are structural placeholders, not a claim about real reported figures.

Unwrapped body for /index-funds (ticker mode only - see this route's description). May instead be a two-key ErrorResponse ({"error": "bad_request" or "not_found", "message": ...}) when no holdings document is routable, or when as_of predates the routable fact sheet.

ticker

string

required

The fund ticker, echoed back uppercase-normalized.

fund

IndexFund · object

required

Fund header for /index-funds: identity, as-of date, and coverage counts for the full fund (not just the returned page). Every field is present only when this server could source it - see go/service/indexfund.go's fund object construction.

Show child attributes

holdings

FundHolding · object[]

required

Sorted by weight descending (holdings with no weight sort last, by ticker-or-name).

Show child attributes

Get ETF / index-fund holdings

curl --request GET \
  --url https://financialdatasets.rip/index-funds \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/index-funds', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/index-funds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/index-funds"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/index-funds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "ticker": "SPY",
  "fund": {
    "name": "Example S&P 500 ETF Trust",
    "as_of": "2025-08-31",
    "source": "public fund holdings fact sheet (markdown)",
    "total_holdings": 503,
    "returned": 1,
    "offset": 0
  },
  "holdings": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "weight": 7.05,
      "market_value": 21000000000,
      "shares": 165000000,
      "asset_class": "equity"
    }
  ]
}

Financial statements

Financial metrics

Earnings

Filings

Prices

News

Insider trades

Screener

Company

KPIs

Not implemented

Macroeconomics

Index funds

Institutional holdings

Ownership

Get ETF / index-fund holdings

Authorizations

Query Parameters

Response