{
  "info": {
    "name": "Investidor B3 — mcp.ai",
    "description": "REST API for the Investidor B3 MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/b3",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "b3_get_carteira",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/carteira",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "carteira"
          ]
        },
        "description": "Resumo da carteira agrupado por classe de ativo (ações, FIIs, renda fixa, etc.) com valor e percentual de cada grupo.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agrupamento\": 0,\n  \"quantidade\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_get_evolucao_patrimonial",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/evolucao/patrimonial",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "evolucao",
            "patrimonial"
          ]
        },
        "description": "Série histórica de evolução do patrimônio na B3.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"ap\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_get_patrimonio",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/patrimonio",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "patrimonio"
          ]
        },
        "description": "Patrimônio total consolidado na B3 (soma de todas as corretoras) numa data. Retorna { valor, data }.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_get_perfil",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/perfil",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "perfil"
          ]
        },
        "description": "Cadastro/perfil do investidor (identidade da conta B3 conectada).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_get_posicao",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/posicao",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "posicao"
          ]
        },
        "description": "Posição DETALHADA por ativo numa data: ticker (codigoNegociacao), quantidade, preço de fechamento, valor atualizado, ISIN, instituição. Agrupado por tipo de produto. Paginado.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"pagina\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_get_ultima_atualizacao",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/ultima/atualizacao",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "ultima",
            "atualizacao"
          ]
        },
        "description": "Data/hora da última carga de dados da B3 (a base é D-1). Use para saber quão fresca está a posição.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_accounts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/accounts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "accounts"
          ]
        },
        "description": "Lista as contas da Área do Investidor B3 conectadas a este install — id, label.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_ativos",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/ativos",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "ativos"
          ]
        },
        "description": "Drill-down nos ativos de UM tipo de produto (informe `codigoProduto`), com valor e percentual de cada ativo do grupo. Para a posição COMPLETA de todos os ativos, use b3_get_posicao.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"codigoProduto\": \"\",\n  \"agrupamento\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_instituicoes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/instituicoes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "instituicoes"
          ]
        },
        "description": "Instituições (corretoras) vinculadas ao investidor na B3.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_movimentacao",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/movimentacao",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "movimentacao"
          ]
        },
        "description": "Movimentação de ativos (entradas/saídas: transferências, subscrições, bonificações, etc.) num intervalo. Paginado.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dataInicio\": \"\",\n  \"dataFim\": \"\",\n  \"pagina\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_negociacoes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/negociacoes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "negociacoes"
          ]
        },
        "description": "Negociações (compras/vendas) num intervalo de datas. Paginado por `page`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dataInicio\": \"\",\n  \"dataFim\": \"\",\n  \"page\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_ofertas_publicas",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/ofertas/publicas",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "ofertas",
            "publicas"
          ]
        },
        "description": "Ofertas públicas (IPOs/subscrições) do investidor num intervalo. Paginado por `page`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dataInicio\": \"\",\n  \"dataFim\": \"\",\n  \"page\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_proventos_a_receber",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/proventos/a/receber",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "proventos",
            "a",
            "receber"
          ]
        },
        "description": "Proventos provisionados a receber (dividendos/JCP futuros) numa data de referência.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"pagina\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "b3_list_proventos_recebidos",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/proventos/recebidos",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "proventos",
            "recebidos"
          ]
        },
        "description": "Proventos já recebidos (dividendos/JCP pagos) num intervalo de datas. Paginado.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dataInicio\": \"\",\n  \"dataFim\": \"\",\n  \"page\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}