> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SEC Form 13F
> Form 13F, lo que cada gestor institucional de más de 100 millones de dólares tiene en acciones públicas de EE. UU.: busca filings por gestor y trimestre, lee las posiciones de un filing y sigue un valor entre todos los gestores que lo tienen.
Todo gestor institucional con al menos 100 millones de dólares en acciones
públicas de Estados Unidos reporta lo que tiene a la Securities and Exchange
Commission dentro de los 45 días del cierre de cada trimestre, en el Form
13F: el gestor, el trimestre y una línea por posición con el emisor, su
CUSIP, el valor en dólares, las acciones, si es una opción y quién vota. El
portafolio de Berkshire Hathaway, cada fondo de pensiones y cada hedge fund
lo bastante grande para presentarlo están aquí, firmados por el gestor.
Todos los filings desde 2013 y las posiciones de los trimestres recientes,
organizados y listos para consultar. Eso es lo que convierte una lista de
todos los gestores que tienen un CUSIP, o el portafolio completo de un gestor
en un trimestre, en una sola llamada rápida. El número CRD del gestor une un
filing con la misma firma en el registro de asesores de inversión, así que el
portafolio público de un gestor y los fondos privados que administra se leen
juntos.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar filings
`POST /us/sec-13f/filings-search/v1` Dataset
Busca los filings por cualquier combinación de nombre del gestor, CIK, CRD,
estado, trimestre y valor total. Del trimestre más reciente al más antiguo.
| Campo | Tipo | Notas |
| ------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre del gestor. Todas deben coincidir; sin lematización. |
| `manager_cik` | string | Opcional. CIK del gestor en EDGAR, con o sin ceros a la izquierda: todos los filings de un gestor. |
| `manager_crd` | string | Opcional. Número CRD del gestor, el mismo id que usa el registro de asesores de inversión. |
| `state` | string | Opcional. Estado de la dirección del gestor, dos letras, p. ej. `NE` o `NY`. |
| `period_from` | string | Opcional. Cierre de trimestre más antiguo reportado (`yyyy-mm-dd`, inclusive), p. ej. `2026-03-31`. |
| `period_to` | string | Opcional. Cierre de trimestre más reciente reportado (`yyyy-mm-dd`, inclusive). |
| `min_value` | number | Opcional. Solo filings cuyas posiciones sumen al menos este monto en dólares. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/sec-13f/filings-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "berkshire hathaway" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `filings[]`, del trimestre más reciente al más antiguo y de mayor a menor dentro de cada uno.
Cada filing incluye `accession_number` (la clave), `filed_on`, `period` (el cierre de trimestre reportado), `submission_type` (`13F-HR` un reporte de posiciones, `13F-NT` un aviso de que otro gestor las reporta, y sus enmiendas `/A`), `is_amendment`, `amendment_number`, `amendment_type`, `report_type`, `manager` (`{ cik, name, crd, sec_file_number, form_13f_file_number, address }`), `holdings_count`, `holdings_value` (en dólares), `other_managers_count`, `confidential_omitted`, `additional_information` y `filing_url`.
Los montos son números en dólares. El Form 13F reportaba los valores en miles hasta las reglas que entraron en vigor en enero de 2023; aquí los montos están normalizados a dólares en toda la serie, así que un filing de 2019 y uno de 2026 se comparan directamente. Se aplica la regla de la propia SEC según la fecha de presentación; una minoría de gestores reportó en dólares antes de 2023 de todos modos, y sus montos antiguos quedan mil veces más altos. Las fechas son `yyyy-mm-dd`. Los campos vacíos son `null`.
La SEC publica el Form 13F en conjuntos de datos trimestrales algunas semanas
después de que cierra cada ventana de presentación, así que la copia está tan
actualizada como el conjunto más reciente: `as_of` dice exactamente cuánto.
## Un filing y sus posiciones
`POST /us/sec-13f/filing/v1` Dataset
Resuelve un Form 13F por su número de acceso y lo devuelve con las posiciones
que reportó, de mayor a menor.
| Campo | Tipo | Notas |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------- |
| `accession_number` | string | **Obligatorio.** Número de acceso de EDGAR, p. ej. `0001193125-26-226661`, como lo devuelve la búsqueda de filings. |
```bash theme={"dark"}
curl https://api.croma.run/us/sec-13f/filing/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "accession_number": "0001193125-26-226661" }'
```
Devuelve `found`, `accession_number`, `as_of`, `filing` (null cuando no se encuentra) y `holdings[]`: las posiciones del filing, de mayor a menor, hasta 200.
Cada filing incluye `accession_number` (la clave), `filed_on`, `period` (el cierre de trimestre reportado), `submission_type` (`13F-HR` un reporte de posiciones, `13F-NT` un aviso de que otro gestor las reporta, y sus enmiendas `/A`), `is_amendment`, `amendment_number`, `amendment_type`, `report_type`, `manager` (`{ cik, name, crd, sec_file_number, form_13f_file_number, address }`), `holdings_count`, `holdings_value` (en dólares), `other_managers_count`, `confidential_omitted`, `additional_information` y `filing_url`.
Los montos son números en dólares. El Form 13F reportaba los valores en miles hasta las reglas que entraron en vigor en enero de 2023; aquí los montos están normalizados a dólares en toda la serie, así que un filing de 2019 y uno de 2026 se comparan directamente. Se aplica la regla de la propia SEC según la fecha de presentación; una minoría de gestores reportó en dólares antes de 2023 de todos modos, y sus montos antiguos quedan mil veces más altos. Las fechas son `yyyy-mm-dd`. Los campos vacíos son `null`.
Cada posición incluye `id` (la clave: el número de acceso del filing y la secuencia de la posición), `accession_number`, `filed_on`, `period`, `manager_cik`, `manager_name`, `manager_crd`, `issuer_name`, `cusip`, `figi`, `class_title`, `value` (en dólares), `shares`, `share_type` (`SH` acciones o `PRN` monto principal), `put_call` (`PUT`, `CALL` o null cuando la posición es el valor mismo), `discretion`, `other_managers`, y la autoridad de voto separada en `voting_sole`, `voting_shared` y `voting_none`.
Los valores están normalizados a dólares en toda la serie. Las fechas son `yyyy-mm-dd`. Los campos vacíos son `null`.
Un número de acceso que ningún Form 13F registra devuelve `found: false` con
HTTP 200, no un error. `holdings` está vacío para un aviso, que no reporta
posiciones propias, y para trimestres anteriores a los que la copia guarda.
## Buscar posiciones
`POST /us/sec-13f/holdings-search/v1` Dataset
Busca las posiciones por cualquier combinación de emisor, gestor, CUSIP,
opciones, trimestre y valor. De mayor a menor.
| Campo | Tipo | Notas |
| ------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre del emisor o del gestor. Todas deben coincidir; sin lematización. |
| `cusip` | string | Opcional. CUSIP del valor, nueve caracteres: todos los gestores que lo tienen. |
| `manager_cik` | string | Opcional. CIK del gestor en EDGAR, con o sin ceros a la izquierda: todos los filings de un gestor. |
| `manager_crd` | string | Opcional. Número CRD del gestor, el mismo id que usa el registro de asesores de inversión. |
| `put_call` | enum | Opcional. `PUT` o `CALL` para ver solo posiciones en opciones; vacío incluye todas. |
| `period_from` | string | Opcional. Cierre de trimestre más antiguo reportado (`yyyy-mm-dd`, inclusive), p. ej. `2026-03-31`. |
| `period_to` | string | Opcional. Cierre de trimestre más reciente reportado (`yyyy-mm-dd`, inclusive). |
| `min_value` | number | Opcional. Solo posiciones de al menos este monto en dólares. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/sec-13f/holdings-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "nvidia", "min_value": 1000000000 }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `holdings[]`, de mayor a menor.
Cada posición incluye `id` (la clave: el número de acceso del filing y la secuencia de la posición), `accession_number`, `filed_on`, `period`, `manager_cik`, `manager_name`, `manager_crd`, `issuer_name`, `cusip`, `figi`, `class_title`, `value` (en dólares), `shares`, `share_type` (`SH` acciones o `PRN` monto principal), `put_call` (`PUT`, `CALL` o null cuando la posición es el valor mismo), `discretion`, `other_managers`, y la autoridad de voto separada en `voting_sole`, `voting_shared` y `voting_none`.
Los valores están normalizados a dólares en toda la serie. Las fechas son `yyyy-mm-dd`. Los campos vacíos son `null`.
Pasa un `cusip` para ver todos los gestores que tienen un valor, o un
`manager_cik` para ver el portafolio de un gestor. La copia guarda los
trimestres recientes; `as_of` dice hasta cuándo, y la búsqueda de filings
cubre todos los trimestres desde 2013.
Esquemas, todos los campos de respuesta y un playground interactivo.