> ## 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, o que cada gestor institucional acima de 100 milhões de dólares detém em ações públicas dos EUA: busque filings por gestor e trimestre, leia as posições de um filing e acompanhe um valor entre todos os gestores que o detêm. Todo gestor institucional com pelo menos 100 milhões de dólares em ações públicas dos Estados Unidos reporta o que detém à Securities and Exchange Commission em até 45 dias do fechamento de cada trimestre, no Form 13F: o gestor, o trimestre e uma linha por posição com o emissor, seu CUSIP, o valor em dólares, as ações, se é uma opção e quem vota. A carteira da Berkshire Hathaway, cada fundo de pensão e cada hedge fund grande o suficiente para apresentá-lo estão aqui, assinados pelo gestor. Todos os filings desde 2013 e as posições dos trimestres recentes, organizados e prontos para consultar. É isso que transforma uma lista de todos os gestores que detêm um CUSIP, ou a carteira completa de um gestor em um trimestre, em uma única chamada rápida. O número CRD do gestor liga um filing à mesma firma no registro de assessores de investimento, então a carteira pública de um gestor e os fundos privados que administra se leem juntos. A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets). ## Buscar filings `POST /us/sec-13f/filings-search/v1` Dataset Busca os filings por qualquer combinação de nome do gestor, CIK, CRD, estado, trimestre e valor total. Do trimestre mais recente ao mais antigo. | Campo | Tipo | Notas | | ------------- | ------- | ------------------------------------------------------------------------------------------------------- | | `query` | string | Opcional. Palavras do nome do gestor. Todas devem coincidir; sem lematização. | | `manager_cik` | string | Opcional. CIK do gestor no EDGAR, com ou sem zeros à esquerda: todos os filings de um gestor. | | `manager_crd` | string | Opcional. Número CRD do gestor, o mesmo id que o registro de assessores de investimento usa. | | `state` | string | Opcional. Estado do endereço do gestor, duas letras, p. ex. `NE` ou `NY`. | | `period_from` | string | Opcional. Fechamento de trimestre mais antigo reportado (`yyyy-mm-dd`, inclusive), p. ex. `2026-03-31`. | | `period_to` | string | Opcional. Fechamento de trimestre mais recente reportado (`yyyy-mm-dd`, inclusive). | | `min_value` | number | Opcional. Apenas filings cujas posições somem pelo menos este valor em dólares. Por padrão `0`. | | `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. | | `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }' ``` Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `filings[]`, do trimestre mais recente ao mais antigo e do maior ao menor dentro de cada um. Cada filing traz `accession_number` (a chave), `filed_on`, `period` (o fechamento de trimestre reportado), `submission_type` (`13F-HR` um relatório de posições, `13F-NT` um aviso de que outro gestor as reporta, e suas emendas `/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` (em dólares), `other_managers_count`, `confidential_omitted`, `additional_information` e `filing_url`. Os montantes são números em dólares. O Form 13F reportava os valores em milhares até as regras que entraram em vigor em janeiro de 2023; aqui os montantes estão normalizados para dólares em toda a série, então um filing de 2019 e um de 2026 se comparam diretamente. A regra da própria SEC é aplicada pela data de apresentação; uma minoria de gestores reportou em dólares antes de 2023 mesmo assim, e seus montantes antigos ficam mil vezes mais altos. As datas são `yyyy-mm-dd`. Os campos vazios são `null`. A SEC publica o Form 13F em conjuntos de dados trimestrais algumas semanas depois que cada janela de apresentação fecha, então a cópia está tão atual quanto o conjunto mais recente: `as_of` diz exatamente o quanto. ## Um filing e suas posições `POST /us/sec-13f/filing/v1` Dataset Resolve um Form 13F pelo seu número de acesso e o retorna com as posições que reportou, da maior à menor. | Campo | Tipo | Notas | | ------------------ | ------ | ---------------------------------------------------------------------------------------------------------------- | | `accession_number` | string | **Obrigatório.** Número de acesso do EDGAR, p. ex. `0001193125-26-226661`, como retornado pela busca 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" }' ``` Retorna `found`, `accession_number`, `as_of`, `filing` (null quando não encontrado) e `holdings[]`: as posições do filing, da maior à menor, até 200. Cada filing traz `accession_number` (a chave), `filed_on`, `period` (o fechamento de trimestre reportado), `submission_type` (`13F-HR` um relatório de posições, `13F-NT` um aviso de que outro gestor as reporta, e suas emendas `/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` (em dólares), `other_managers_count`, `confidential_omitted`, `additional_information` e `filing_url`. Os montantes são números em dólares. O Form 13F reportava os valores em milhares até as regras que entraram em vigor em janeiro de 2023; aqui os montantes estão normalizados para dólares em toda a série, então um filing de 2019 e um de 2026 se comparam diretamente. A regra da própria SEC é aplicada pela data de apresentação; uma minoria de gestores reportou em dólares antes de 2023 mesmo assim, e seus montantes antigos ficam mil vezes mais altos. As datas são `yyyy-mm-dd`. Os campos vazios são `null`. Cada posição traz `id` (a chave: o número de acesso do filing e a sequência da posição), `accession_number`, `filed_on`, `period`, `manager_cik`, `manager_name`, `manager_crd`, `issuer_name`, `cusip`, `figi`, `class_title`, `value` (em dólares), `shares`, `share_type` (`SH` ações ou `PRN` montante principal), `put_call` (`PUT`, `CALL` ou null quando a posição é o próprio valor), `discretion`, `other_managers`, e a autoridade de voto separada em `voting_sole`, `voting_shared` e `voting_none`. Os valores estão normalizados para dólares em toda a série. As datas são `yyyy-mm-dd`. Os campos vazios são `null`. Um número de acesso que nenhum Form 13F registra retorna `found: false` com HTTP 200, não um erro. `holdings` fica vazio para um aviso, que não reporta posições próprias, e para trimestres anteriores aos que a cópia guarda. ## Buscar posições `POST /us/sec-13f/holdings-search/v1` Dataset Busca as posições por qualquer combinação de emissor, gestor, CUSIP, opções, trimestre e valor. Da maior à menor. | Campo | Tipo | Notas | | ------------- | ------- | ------------------------------------------------------------------------------------------------------- | | `query` | string | Opcional. Palavras do nome do emissor ou do gestor. Todas devem coincidir; sem lematização. | | `cusip` | string | Opcional. CUSIP do valor, nove caracteres: todos os gestores que o detêm. | | `manager_cik` | string | Opcional. CIK do gestor no EDGAR, com ou sem zeros à esquerda: todos os filings de um gestor. | | `manager_crd` | string | Opcional. Número CRD do gestor, o mesmo id que o registro de assessores de investimento usa. | | `put_call` | enum | Opcional. `PUT` ou `CALL` para ver apenas posições em opções; vazio inclui todas. | | `period_from` | string | Opcional. Fechamento de trimestre mais antigo reportado (`yyyy-mm-dd`, inclusive), p. ex. `2026-03-31`. | | `period_to` | string | Opcional. Fechamento de trimestre mais recente reportado (`yyyy-mm-dd`, inclusive). | | `min_value` | number | Opcional. Apenas posições de pelo menos este valor em dólares. Por padrão `0`. | | `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. | | `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `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 }' ``` Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `holdings[]`, do maior ao menor. Cada posição traz `id` (a chave: o número de acesso do filing e a sequência da posição), `accession_number`, `filed_on`, `period`, `manager_cik`, `manager_name`, `manager_crd`, `issuer_name`, `cusip`, `figi`, `class_title`, `value` (em dólares), `shares`, `share_type` (`SH` ações ou `PRN` montante principal), `put_call` (`PUT`, `CALL` ou null quando a posição é o próprio valor), `discretion`, `other_managers`, e a autoridade de voto separada em `voting_sole`, `voting_shared` e `voting_none`. Os valores estão normalizados para dólares em toda a série. As datas são `yyyy-mm-dd`. Os campos vazios são `null`. Passe um `cusip` para ver todos os gestores que detêm um valor, ou um `manager_cik` para ver a carteira de um gestor. A cópia guarda os trimestres recentes; `as_of` diz até quando, e a busca de filings cobre todos os trimestres desde 2013. Esquemas, todos os campos de resposta e um playground interativo.