> ## Documentation Index
> Fetch the complete documentation index at: https://octo-98895abd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# fund_restatements

> Restatement events from the B3 Fundos.NET (FNET) register: one row per document with versao > 1 (modalidade RE voluntary or RC CVM-required, as published), newest delivery first, with cnpj from its cnpjFundo link (NULL when SILO's fortnightly sweep has not linked it yet — served, never dropped), tipo_fundo from its tipoFundo link (FII / FIDC / ETF; NULL when none), and previous_fnet_id / previous_delivered_at / lag_days for the version it most plausibly replaced. FNET DOES NOT LINK VERSIONS, so the pairing is by a stated group key — (cnpj link, categoria, tipo_documento, especie, reference_raw) — never by fund_name: previous is the group's document with the highest versao below this one, the greatest fnet_id winning a tie, because a group can legitimately hold several v1 documents (assemblies). Unlinked documents and documents with no reference text are never paired (previous_* NULL). lag_days = delivery date minus the previous delivery date. diff_status says whether SILO has diffed this exact pair (fnet_document_pair.status: compared, or why not — unpairable_no_link, unpairable_no_reference, no_predecessor, body_not_xml, parse_error, unsupported_root, declared_mismatch, body_hash_mismatch; NULL = not diffed, which is every document outside the FIDC informe mensal for now; it is as of the last daily diff run, so a document linked or backfilled since shows its earlier status until the next one), and n_fields_changed is how many rows api.fund_restatement_diff returns for it (NULL unless compared; 0 = re-filed with no field changed). Filter by p_cnpj (window verbatim, NULL = whole history) or by a delivery window (default the 30 days before p_to or today); p_tipo_fundo takes FII, FIDC or ETF and anything else raises 22023. More than 1000 rows RAISES 22023 (never trimmed): narrow the window or pin p_cnpj / p_tipo_fundo.

**Row cap.** A window producing more than 1000 rows raises SQLSTATE `22023` naming this function. Nothing is trimmed to fit — PostgREST would silently cut the response at 1000 and a cut-short series is indistinguishable from one that simply ends. This function does not page — narrow the window instead.



## OpenAPI

````yaml /openapi.json post /rpc/fund_restatements
openapi: 3.1.0
info:
  title: SILO Data API
  version: '75'
  summary: >-
    Read-only Brazilian public financial data: CVM filings, BACEN series, B3
    quotes and the B3 BDI group.
  description: >
    Schema `api` over PostgREST. Views are `GET /<view>`; functions are

    `POST /rpc/<function>` with a JSON body.


    **This document is generated** from the live Postgres catalog by

    `scripts/gen_openapi.py` — `pg_get_function_arguments` for the RPC
    signatures,

    `information_schema.columns` for the view columns, and the granted-to-`anon`

    privilege set for which objects exist at all. It is not hand-maintained, and

    `tests/test_openapi_spec.py` fails the build when it drifts from the SQL.


    ### Two different ceilings


    Reading one for the other is the most expensive mistake on this API.


    * **The row cap refuses.** Fifty-nine set-returning functions raise SQLSTATE
      `22023` when the window they were handed would produce more than 1000 rows.
      Nothing is trimmed, and the error says why and how to fix it (the message,
      plus PostgREST's `details` and `hint`). Five of them (`panel`,
      `quote_history`, `fund_nav`, `index_history`, `trade_consolidated_history`)
      take a `p_after` cursor so you can walk the series; the other fifty-four ask you to narrow the window. `fund_nav` paging
      additionally REQUIRES `p_entity_type` — its cursor is a bare period, which
      is unique only within one family, and CNPJs that file under both `fi` and
      `fidc` in the same month would otherwise be ambiguous.
    * **The tier ceiling clamps.** Three other functions (`search_funds`,
      `option_chain`, `option_exercises`) silently lower `p_limit` to a per-tier maximum. No error is raised, so the
      only way to know the result was cut is to know the ceiling. Signing in
      raises it.

    Separately from both, PostgREST's server-wide `db-max-rows = 1000` cuts
    every

    response, on every endpoint, for every tier. On the GET views
    `Content-Range`

    is the signal (`0-999/*`); `Prefer: count=exact` turns the `*` into a total.


    ### Retention


    Most of this warehouse is append-only history. The **B3 BDI group** —

    `short_interest`, `short_interest_by_sector`, `investor_flow`,

    `lending_trades`, `lending_participants` — is not: B3 keeps roughly 21
    business

    days and publishes no archive. A missed session cannot be bought back. See

    Market Coverage.
  license:
    name: See repository
    url: https://github.com/PedroDnT/SILO-BZ
servers:
  - url: https://zcjbtpxuhdekpwcxmepn.supabase.co/rest/v1
    description: Supabase PostgREST, schema `api`
security:
  - apikey: []
tags:
  - name: ANBIMA
  - name: Company events
  - name: Coverage & catalog
  - name: Derivatives
  - name: FIDC
  - name: FNET documents
  - name: Financials
  - name: Funds
  - name: Holdings
  - name: Inflation
  - name: Lookup
  - name: Macro
  - name: Macro expectations
  - name: Other
  - name: Panel
  - name: Portfolio
  - name: Quotes
  - name: Rates
  - name: Research
  - name: Screens
  - name: Securities lending
  - name: Short interest & flows
paths:
  /rpc/fund_restatements:
    post:
      tags:
        - FNET documents
      summary: fund_restatements
      description: >-
        Restatement events from the B3 Fundos.NET (FNET) register: one row per
        document with versao > 1 (modalidade RE voluntary or RC CVM-required, as
        published), newest delivery first, with cnpj from its cnpjFundo link
        (NULL when SILO's fortnightly sweep has not linked it yet — served,
        never dropped), tipo_fundo from its tipoFundo link (FII / FIDC / ETF;
        NULL when none), and previous_fnet_id / previous_delivered_at / lag_days
        for the version it most plausibly replaced. FNET DOES NOT LINK VERSIONS,
        so the pairing is by a stated group key — (cnpj link, categoria,
        tipo_documento, especie, reference_raw) — never by fund_name: previous
        is the group's document with the highest versao below this one, the
        greatest fnet_id winning a tie, because a group can legitimately hold
        several v1 documents (assemblies). Unlinked documents and documents with
        no reference text are never paired (previous_* NULL). lag_days =
        delivery date minus the previous delivery date. diff_status says whether
        SILO has diffed this exact pair (fnet_document_pair.status: compared, or
        why not — unpairable_no_link, unpairable_no_reference, no_predecessor,
        body_not_xml, parse_error, unsupported_root, declared_mismatch,
        body_hash_mismatch; NULL = not diffed, which is every document outside
        the FIDC informe mensal for now; it is as of the last daily diff run, so
        a document linked or backfilled since shows its earlier status until the
        next one), and n_fields_changed is how many rows
        api.fund_restatement_diff returns for it (NULL unless compared; 0 =
        re-filed with no field changed). Filter by p_cnpj (window verbatim, NULL
        = whole history) or by a delivery window (default the 30 days before
        p_to or today); p_tipo_fundo takes FII, FIDC or ETF and anything else
        raises 22023. More than 1000 rows RAISES 22023 (never trimmed): narrow
        the window or pin p_cnpj / p_tipo_fundo.


        **Row cap.** A window producing more than 1000 rows raises SQLSTATE
        `22023` naming this function. Nothing is trimmed to fit — PostgREST
        would silently cut the response at 1000 and a cut-short series is
        indistinguishable from one that simply ends. This function does not page
        — narrow the window instead.
      operationId: rpc_fund_restatements
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                p_cnpj:
                  type:
                    - string
                    - 'null'
                  description: Defaults to `NULL::text`.
                  default: null
                p_from:
                  type:
                    - string
                    - 'null'
                  format: date
                  description: Defaults to `NULL::date`.
                  default: null
                p_to:
                  type:
                    - string
                    - 'null'
                  format: date
                  description: Defaults to `NULL::date`.
                  default: null
                p_tipo_fundo:
                  type:
                    - string
                    - 'null'
                  description: Defaults to `NULL::text`.
                  default: null
      responses:
        '200':
          description: >-
            The result set, newest delivery first. An unknown id is an empty
            array, not a 404 and never a guessed value.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    fnet_id:
                      type:
                        - integer
                        - 'null'
                      format: int64
                    cnpj:
                      type:
                        - string
                        - 'null'
                    tipo_fundo:
                      type:
                        - string
                        - 'null'
                    fund_name:
                      type:
                        - string
                        - 'null'
                    tipo_documento:
                      type:
                        - string
                        - 'null'
                    reference_raw:
                      type:
                        - string
                        - 'null'
                    reference_date:
                      type:
                        - string
                        - 'null'
                      format: date
                    versao:
                      type:
                        - integer
                        - 'null'
                      format: int32
                    modalidade:
                      type:
                        - string
                        - 'null'
                    delivered_at:
                      type:
                        - string
                        - 'null'
                      format: date-time
                    previous_fnet_id:
                      type:
                        - integer
                        - 'null'
                      format: int64
                    previous_delivered_at:
                      type:
                        - string
                        - 'null'
                      format: date-time
                    lag_days:
                      type:
                        - integer
                        - 'null'
                      format: int32
                    n_fields_changed:
                      type:
                        - integer
                        - 'null'
                      format: int32
                    diff_status:
                      type:
                        - string
                        - 'null'
        '400':
          description: >-
            Bad request. Contract violations raise SQLSTATE `22023` with a
            message naming the limit or the argument at fault.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            No usable `apikey`, or a request for a schema outside `api`.
            `Accept-Profile: public` and any `cvm_*` / `b3_cotahist` / `cia_*`
            path answer 401 for every caller, by grant — schema `api` is the
            entire public surface.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such endpoint in schema `api`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      description: >-
        PostgREST error body. `code` carries the SQLSTATE — `22023` is a
        contract refusal.
      properties:
        code:
          type:
            - string
            - 'null'
          examples:
            - '22023'
        message:
          type:
            - string
            - 'null'
        details:
          type:
            - string
            - 'null'
        hint:
          type:
            - string
            - 'null'
  securitySchemes:
    apikey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        The publishable key (`sb_publishable_…`), on every request. It is NOT a
        JWT — sending it as `Authorization: Bearer` is rejected as an invalid
        JWT. It identifies the project, not you, and maps to the Postgres `anon`
        role.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.