Health assessment

GET/api/fund/fund-health

Comprehensive fund health assessment sourced from SEC N-CEN and N-PORT filings. Includes tracking quality metrics (for index funds), fair value hierarchy breakdown, liquidity classification, default/arrears status, operational red flags, and service provider summary.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Fund ticker symbol (ETF or mutual fund). Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: SPY
cik integer optional

SEC Central Index Key (CIK).

Example: 884394
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000BDTBL9
share_class_figi string optional

Share-class OpenFIGI identifier.

Example request

curl 'https://api.stockfit.io/v1/api/fund/fund-health?symbol=SPY&cik=884394&composite_figi=BBG000BDTBL9' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Fund health data

Response schema

reportDate string | null
ncenRecords array of object
Annual N-CEN census data with tracking quality and red flags
array of:
- reportDate string
- isIndexFund boolean
- indexReturnDiffBefore number | null
  Tracking difference before expenses (%)
- indexReturnDiffAfter number | null
  Tracking difference after expenses (%)
- indexStdevBefore number | null
  Tracking error volatility before expenses
- indexStdevAfter number | null
  Tracking error volatility after expenses
- isLendingAuthorized boolean
- didLend boolean
- isLendingLiquidated boolean
- hasMaterialWeakness boolean
  Internal control material weakness reported
- hasLegalProceedings boolean
- hasValuationChanges boolean
- hasAccountingChanges boolean
- hasPaymentErrors boolean
liquidity array of object
Holdings by liquidity classification (HLI = Highly Liquid, MLI = Moderately Liquid, LLI = Less Liquid, ILI = Illiquid)
array of:
- category string (enum)
  Allowed values: HLI, MLI, LLI, ILI
- count integer
- totalValue number
- totalWeight number
  Percentage of portfolio
fairValue array of object
Holdings by fair value hierarchy (Level 1 = quoted prices, Level 2 = observable inputs, Level 3 = unobservable/model-based)
array of:
- level integer (enum)
  Allowed values: 1, 2, 3
- count integer
- totalValue number
- totalWeight number
defaults object
Holdings in default or arrears
- defaults integer
- arrears integer
- total integer
serviceProviders array of object
Service providers from the latest N-CEN filing
array of:
- providerRole string
- providerName string
- isAffiliated boolean

Example response

{
  "reportDate": "2025-06-30",
  "ncenRecords": [
    {
      "reportDate": "2025-06-30",
      "isIndexFund": true,
      "indexReturnDiffBefore": -0.03,
      "indexReturnDiffAfter": -0.12,
      "indexStdevBefore": 0.01,
      "indexStdevAfter": 0.02,
      "isLendingAuthorized": true,
      "didLend": true,
      "isLendingLiquidated": true,
      "hasMaterialWeakness": true,
      "hasLegalProceedings": true,
      "hasValuationChanges": true,
      "hasAccountingChanges": true,
      "hasPaymentErrors": true
    }
  ],
  "liquidity": [
    {
      "category": "HLI",
      "count": 490,
      "totalValue": 700000000000,
      "totalWeight": 98.3
    }
  ],
  "fairValue": [
    {
      "level": 1,
      "count": 498,
      "totalValue": 710000000000,
      "totalWeight": 99.7
    }
  ],
  "defaults": {
    "defaults": 0,
    "arrears": 0,
    "total": 0
  },
  "serviceProviders": [
    {
      "providerRole": "custodian",
      "providerName": "STATE STREET BANK AND TRUST COMPANY",
      "isAffiliated": true
    }
  ]
}

400 Bad Request

Symbol not found or no N-CEN data available

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}