Funds
SEC N-PORT fund holdings and N-PX proxy-voting records for registered investment funds.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/funds/holdings
Holdings
Return one fund's bounded, cursor-paged SEC Form N-PORT holdings.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| fund | string | Yes | — | min length 1 | SEC series id or fund class ticker |
| report_period | string | null | No | — | — | Exact N-PORT period of report (YYYY-MM-DD); omit for latest |
| limit | integer | No | 50 | min 1, max 200 | Holdings rows per page |
| cursor | string | null | No | — | — | Opaque pagination.next_cursor from the previous response |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/funds/holdings?fund=FUND"Response
200 Successful Response · expand a branch to see its fields.
dataFundsGetHoldingsDatarequiredA bounded page of positions from one pinned N-PORT accession.
holdingsarray<FundHolding>required
- issuer_namestringrequirednullable
- issuer_leistringrequirednullable
- titlestringrequirednullable
- tickerstringrequirednullable
- other_idstringrequirednullable
- other_id_descstringrequirednullable
- balancestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- unitsstringrequirednullable
- units_descstringrequirednullable
- currency_codestringrequirednullable
- exchange_ratestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- value_usdstringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- pct_valuestringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- payoff_profilestringrequirednullable
- asset_categorystringrequirednullable
- asset_category_descstringrequirednullable
- issuer_categorystringrequirednullable
- issuer_category_descstringrequirednullable
- inv_countrystringrequirednullable
- is_restrictedbooleanrequirednullable
- fair_value_levelstringrequirednullable
metaFundsGetHoldingsMetarequiredFund identity, filing lineage, and SEC source attribution. ``as_of`` carries the filing's report-period date — the date-grained arm of the shared ``Meta.as_of`` contract — not an ingestion timestamp.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- series_idstringrequired
- series_namestringrequirednullable
- registrant_namestringrequirednullable
- cikintegerrequired
- form_typestringrequired
- accession_numberstringrequired
- filed_datestring (date)required
- report_periodstring (date)required
- holdings_countintegerrequired
- attributionstringrequired
- primary_document_urlstringrequired
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/funds/proxy-votes
Proxy Votes
Return a fund's or manager's bounded, cursor-paged Form N-PX votes.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| fund | string | Yes | — | min length 1 | Registrant CIK, SEC series id, or fund class ticker |
| category | string | null | No | — | — | Standardized N-PX proposal category |
| report_period | string | null | No | — | — | Exact N-PX period of report (YYYY-MM-DD); omit for latest |
| ticker | string | null | No | — | — | Issuer ticker; resolved issuers only |
| limit | integer | No | 25 | min 1, max 100 | Proxy-vote rows per page |
| cursor | string | null | No | — | — | Opaque pagination.next_cursor from the previous response |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/funds/proxy-votes?fund=FUND"Response
200 Successful Response · expand a branch to see its fields.
dataFundsGetProxyVotesDatarequiredA bounded page of proxy-vote rows from one pinned N-PX report period.
- fundstringrequired
- categorystringrequirednullable
- tickerstringrequirednullable
votesarray<ProxyVoteRow>required
- accession_numberstringrequired
- as_ofstring (date)required
- record_seqintegerrequired
- issuer_namestringrequired
- tickerstringrequirednullable
- meeting_datestring (date)requirednullable
- vote_descriptionstringrequired
- categoriesarray<string>required
- vote_seriesstringrequirednullable
- shares_on_loanstringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- how_votedstringrequirednullable
- shares_votedstringrequirednullablepattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- management_recommendationstringrequirednullable
metaFundsGetProxyVotesMetarequiredFund identity, filing lineage, and SEC source attribution.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- attributionstringrequired
- filer_cikintegerrequired
- filer_namestringrequired
- series_idstringrequirednullable
- series_namestringrequirednullable
- report_periodstring (date)required
- report_calendar_yearintegerrequired
- total_votesintegerrequired
filingsarray<ProxyVoteFilingRef>required
- accession_numberstringrequired
- form_typestringrequired
- report_typestringrequired
- amendment_typestringrequirednullable
- filed_datestring (date)required
- primary_document_urlstringrequired
- vote_table_urlstringrequirednullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/funds/search
Search
Return ranked SEC investment-company registry matches.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | min length 1 | Fund ticker, series name, or registrant name |
| limit | integer | No | 10 | min 1, max 50 | Maximum ranked fund matches |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/funds/search?query=QUERY"Response
200 Successful Response · expand a branch to see its fields.
dataFundsSearchFundsDatarequiredThe echoed query and its bounded, best-first fund matches.
- querystringrequired
fundsarray<FundSearchMatch>required
- cikintegerrequired
- registrant_namestringrequirednullable
- series_idstringrequired
- series_namestringrequirednullable
- class_idstringrequired
- class_namestringrequirednullable
- tickerstringrequirednullable
metaFundsSearchFundsMetarequiredSEC registry provenance for a fund-entity search.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- attributionstringrequired
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable