GET /v1/funds/nport/holdings

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/funds/nport/holdings"

{
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Return the latest SEC N-PORT holdings roster with explicit capability semantics and balance-unit metadata

Audience: application and coding agent.

Agent mode

Pass ?view=agent to receive the compact agent shape: fund identifiers (ticker, cik, fundName, form, filingDate, accessionNumber, holdingCount) + lifted filingUrl + nested holdings[] trimmed to 6 fields per holding (issuer, cusip, valueUsd, balance, balanceUnit, pctNetAssets). Title, isin, assetType, issuerType, country, currency, summaryMd, and metadata envelopes are dropped. Typical reduction: ~60%. See api conventions → response formats for the full ?view= contract.

Canonical metadata

requestId
traceparent

Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/funds/nport/holdings"

Example response

{
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

Funds Insiders

​Agent mode

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Agent mode

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture