# Stillhouse Data API (v1)

REST access to SEC Form ADV investment adviser data: firm search and detail,
adviser rep movements, 13F holdings, and ADV Part 2 brochures.

Base URL: https://api.stillhousedata.com/v1

## Authentication

Every request requires an API key. Free keys are self-serve: sign in at
https://docs.stillhousedata.com/keys.html (10 calls/min, 1 active key per
account, adviser search/list/firm-profile endpoints). For brochures, higher limits, or bulk
access, contact tjj@stanford.edu. Pass the key either way:

  Authorization: Bearer cove_...
  X-Api-Key: cove_...

The key must carry the "api" scope (mcp-only keys get 403). Endpoints marked
[contact] below are NOT included by default; self-serve keys get 403 there.
Contact tjj@stanford.edu if you want access to the additional endpoints. Keep
keys server-side. Verify connectivity: GET /v1/me

## Rate limits (per key, independent buckets)

  search bucket: 10/min  - /adv/advisers/search, /adv/advisers/list, /brochures/search
  general bucket: 10/min - everything else

Standard RateLimit-* response headers. 429 body: { "error": "..." }

## Errors

  401 missing/invalid/revoked key
  403 key lacks a required scope ("api", or "brochures" for brochure endpoints)
  404 unknown endpoint or entity not found
  429 rate limited
All errors: { "error": "..." }

## Endpoints - Form ADV (firms keyed by CRD number)

GET /v1/adv/advisers/search?q=&limit=            [search] name typeahead; q >= 2 chars; limit <= 25
GET /v1/adv/advisers/list?q=&state=&adviser_type=&fund_type=&exclude_terminated=&has_disciplinary=&sort=raum|date|name&order=asc|desc&limit=&offset= [search]
                                                 filtered paginated firm list
GET /v1/adv/advisers/by-crd/{crd}?include=       firm profile. Default = compact core (identity,
                                                 latest-filing summary, fund counts; a few KB).
                                                 include= comma-separated sections or "all":
                                                 filings, funds, service_providers, drp, people,
                                                 branches, part1a, sma, linked. Full (=all) can
                                                 exceed 100KB for large firms.
GET /v1/adv/advisers/by-crd/{crd}/rep-flows [contact] rep arrivals/departures (IAPD history, 1985-present)
GET /v1/adv/advisers/by-crd/{crd}/holdings-13f [contact] latest 13F equity holdings
GET /v1/adv/advisers/by-crd/{crd}/registered-funds [contact] N-CEN registered funds
GET /v1/adv/advisers/by-crd/{crd}/money-market-funds [contact] N-MFP money market funds
GET /v1/adv/advisers/by-crd/{crd}/headcount [contact] monthly headcount time series
GET /v1/adv/advisers/by-crd/{crd}/filing-activity?years= [contact] per-day filing activity
GET /v1/adv/advisers/by-crd/{crd}/similar?limit= [contact] similar firms
GET /v1/adv/rep/{indvlPk}/movements [contact]    one rep's career history (indvlPk from rep-flows)

## Endpoints - ADV Part 2 brochures (full-text, markdown) - contact for access, not included by default

GET /v1/brochures/search?q=&page=&size= [contact] [search] full-text search, one row per firm; size <= 50
GET /v1/brochures/firm/{crd} [contact]           all brochure versions for a firm, newest first
GET /v1/brochures/{id} [contact]                 one brochure incl. full markdown text

## Meta

GET /v1/me                                       echoes key id, scopes, limits (general bucket)

Data is public SEC/FINRA filing data, republished with processing. No warranty;
verify against primary sources. Do not resell raw bulk extracts.