Movimentação de cotas - v1.0.0

Cadastro de solicitação de movimentação de cotas

POST <hub-anbima>:/v1/movimentacao-cotas/solicitacoes

Tipo de rota: Síncrona

Para acessar os tipos e formatos dos campos, consultar a lista de campos de Movimentação de cota.

Método utilizado para criar uma solicitação de movimentação de cotas. Por se tratar de uma solicitação que pode conter diversos movimentos, ela passará por uma série de validações e processos assíncronos.

Se as validações básicas passarem com sucesso (processos síncronos), a solicitação é aceita para processamento(segue de forma assíncrona).

Limites de Taxa (Rate Limit)

Para garantir a estabilidade e o uso justo de nossas APIs para todos os desenvolvedores, aplicamos limites na quantidade de requisições que podem ser feitas em determinados intervalos de tempo. O desrespeito a esses limites resultará em respostas de erro.

Nossos Limites Existem dois níveis de controle de taxa em vigor: um limite geral para cada endpoint e um limite específico por clienteID para as APIs externas.

Tipo de Limite	Requisições por segundo	Endpoints Afetados
Limite Geral por Endpoint	200	Todos os endpoints do nosso serviço de borda.
Limite por Cliente	20	Consulta Solicitação, Consulta Informe e Cadastro de Informe.

Header

Authorization: Bearer {access_token}

Body

Limite máximo de 10MB

[
  {
    "data": date(AAAA-MM-DD),
    "classe_compra_cotas": "string",
    "classe_investidora": {
      "cnpj_classe_investidora": "string",
      "classe_investida": [
        {
          "cnpj_classe_investida": "string",
          "codigoanbima_subclasse_investida": "string",
          "codigocvm_subclasse_investida": "string",
          "valor_financeiro_comprado": number,
          "valor_financeiro_vendido": number,
          "valor_posicao_final_investida": number
        }
      ]
    }
  },
]

Exemplo de preenchimento

[
  {
    "data": "2025-11-23",
    "classe_compra_cotas": "Sim",
    "classe_investidora": {
      "cnpj_classe_investidora": "00000000000000",
      "classe_investida": [
        {
          "cnpj_classe_investida": "00000000000000",
          "codigoanbima_subclasse_investida": "4BCDE0000000000",
          "codigocvm_subclasse_investida": "S0000000000",
          "valor_financeiro_comprado": 10000.10000,
          "valor_financeiro_vendido": 10000.10000,
          "valor_posicao_final_investida": 10000.10000
        }
      ]
    }
  },
  {
    "data": "2025-11-23",
    "classe_compra_cotas": "Sim",
    "classe_investidora": {
      "cnpj_classe_investidora": "00000000000000",
      "classe_investida": [
        {
          "cnpj_classe_investida": "00000000000000",
          "codigoanbima_subclasse_investida": "4BCDE0000000000",
          "codigocvm_subclasse_investida": "S0000000000",
          "valor_financeiro_comprado": 10000.10000,
          "valor_financeiro_vendido": 10000.10000,
          "valor_posicao_final_investida": 10000.10000
        },
        {
          "cnpj_classe_investida": "00000000000000",
          "codigoanbima_subclasse_investida": "4BCDE0000000000",
          "codigocvm_subclasse_investida": "S0000000000",
          "valor_financeiro_comprado": 10000.10000,
          "valor_financeiro_vendido": 10000.10000,
          "valor_posicao_final_investida": 10000.10000
        }
      ]
    }
  }
]

Sucesso

Status code - 201 (Created)

{
  "data": {
    "numero_solicitacao": "string",
    "status": "string",
    "movimentacoes": [
      {
        "cnpj_classe_investidora": "string",
        "status_movimento": "string"
      }
    ]
  },
  "message": "string",
  "type": "string"
}

Falhas

Status code 400 - BadRequest

{
  "statusCode": number,
  "message": [
    "string"
  ],
  "type": "string",
  "error": "string"
}

Status code 401 - Unauthorized

{
  "statusCode": number,
  "message": "string",
 }

Status code 404 - Not found

{
  "statusCode": number,
  "message": "string",
  "error": "string"
}

Status code 429 - Too Many Requests

{
  "statusCode": number,
  "message": "string",
  "error": "string"
}

Status code 500 - Error

{
  "statusCode": number,
  "message": "string",
}

Acompanhamento de solicitação de Informes

GET <hub-anbima>:/v1/movimentacao-cotas/solicitacoes/{numeroSolicitacao}?page={page}&page-size={page-size}

Tipo de rota: Síncrona

Para acessar os tipos e formatos dos campos, consultar a lista de campos de Movimentação de Cotas.

Endpoint utilizado para recuperar todos os informes e status da solicitação enviada como parâmetro.

Header

Authorization: Bearer {access_token}

Pagination Query

page: number

page-size: number

Parâmetros

numeroSolicitacao: string

Response

Status Ok - 200

{
  "data": {
    "numero_solicitacao": "string",
    "data_criacao":  date(AAAA-MM-DD),
    "data_ultima_atualizacao":  date(AAAA-MM-DD),
    "status" : "string",
    "movimentacoes": [
      {
        "data":  date(AAAA-MM-DD),
        "classe_compra_cotas": "string",
        "classe_investidora": {
          "identificador_classe_investidora": "string",
          "cnpj_classe_investidora": "string",
          "status_movimento" : "string",
          "classe_investida": [
            {
              "cnpj_classe_investida": "string",
              "codigoanbima_subclasse_investida": "string",
              "codigocvm_subclasse_investida": "string",
              "valor_financeiro_comprado": number,
              "valor_financeiro_vendido": number,
              "valor_posicao_final_investida": number
            }
          ]
        }
      }
    ]
  },
  "pagination": {
    "totalItems": number,
    "page": number,
    "pageSize": number,
    "totalPages": number
  },
  "message": "string",
  "type": "string"
}

Errors

Status code 400 - BadRequest

{
  "statusCode": number,
  "message": [
    "string"
  ],
  "type": "string",
  "error": "string"
}

Status code 401 - Unauthorized

{
  "statusCode": number,
  "message": "string",
 }

Status code 404 - Not found

{
  "statusCode": number,
  "message": "string",
  "error": "string"
}

Status code 500 - Error

{
  "statusCode": number,
  "message": "string",
}

Acompanhamento de um Informe

GET <hub-anbima>:/v1/movimentacao-cotas/solicitacoes/{numeroSolicitacao}/classes-investidoras/{cnpjClasseInvestidora}?page={page}&page-size={page-size}

Tipo de rota: Síncrona

Para acessar os tipos e formatos dos campos, consultar a lista de campos de Movimentação de Cotas.

Header

Authorization: Bearer {access_token}

Pagination Query

page: number
page-size: number

Parâmetros

numeroSolicitacao: string
cnpjClasseInvestidora: string

Response

Status Code Ok - 200

{
  "data": {
    "data":  date(AAAA-MM-DD),
    "classe_compra_cotas": "string",
    "classe_investidora": {
      "identificador_classe_investidora": "string",
      "cnpj_classe_investidora": "string",
      "classe_investida": [
        {
          "status_movimento" : "string",
          "cnpj_classe_investida": "string",
          "codigoanbima_subclasse_investida": "string",
          "codigocvm_subclasse_investida": "string",
          "valor_financeiro_comprado": number,
          "valor_financeiro_vendido": number,
          "valor_posicao_final_investida": number
        }
      ]
    }
  },
  "pagination": {
    "totalItems": number,
    "page": number,
    "pageSize": number,
    "totalPages": number
  },
  "message": "string",
  "type": "string"
}

Errors

Status code 400 - BadRequest

{
  "statusCode": number,
  "message": [
    "string"
  ],
  "type": "string",
  "error": "string"
}

Status code 401 - Unauthorized

{
  "statusCode": number,
  "message": "string",
 }

Status code 404 - Not found

{
  "statusCode": number,
  "message": "string",
  "error": "string"
}

Status code 500 - Error

{
  "statusCode": number,
  "message": "string",
}