API de inteligência de carteiras

O veredicto sobre qualquer carteira. Uma única chamada de API.

Envie suas posições por POST para um único endpoint. A PORTIQA retorna uma pontuação composta, equilíbrio de risco, concentração, resiliência e o que precisa de atenção em seguida — avaliado com base em 70.000 ativos em 45 mercados.

Obter uma chave de API gratuita Ler a documentação →

1 endpoint 70,000 ativos 45 mercados 5 chamadas grátis / mês

portiqa — evaluate AO VIVO

POST /evaluate HTTP/1.1 Authorization: Bearer pq_live_•••••••• { "positions": [ { "ticker": "AAPL", "value": 12000 }, { "ticker": "MSFT", "value": 8000 }, { "ticker": "NVDA", "value": 5000 } ] }

200 OK · application/json

{ "score": 78.1, "status": "Good", "top_sector": "Technology", "top_sector_weight": 75.8, "exposure_plan": { "target_invested_pct": 72.0, "target_cash_pct": 28.0, "stance": "balanced" }, "suggestions": [ /* 3 items */ ] }

78.1 Boa

70,000Ativos cobertos

45Mercados

1Endpoint

5Avaliações gratuitas / mês

O que uma única chamada retorna.

Cada campo da resposta merece seu lugar. O mesmo motor em todos os planos — os preços mudam apenas quantas chamadas você faz. Veja o esquema completo na referência da API.

evaluation.score

Pontuação composta

Um número, de 0 a 100, que pondera a saúde da alocação, o equilíbrio de risco e a resiliência — comparável entre quaisquer carteiras.

evaluation.status

Veredicto em linguagem clara

Um status legível que seus usuários entendem na hora — sem exigir formação quantitativa para agir.

top_sector_weight

Leitura de concentração

Onde a carteira está sobreponderada e a que distância está de uma distribuição saudável — por setor e por posição.

exposure_plan

Plano de exposição

Divisão-alvo entre investido e caixa com uma postura declarada, ajustada ao regime de mercado atual.

risk_profile

Equilíbrio de risco

Como o risco da carteira realmente se distribui — exposições a fatores confrontadas com o perfil do investidor.

suggestions[]

Próximos passos concretos

Sugestões específicas e priorizadas para fortalecer a carteira — instruções, não observações.

Uma requisição de entrada. Um veredicto de saída.

Envie suas posições, a PORTIQA as avalia com dados de regime em tempo real e você recebe uma resposta decisiva — tudo em uma única chamada de API.

Você envia

Suas posições

{
  "positions": [
    { "ticker": "AAPL", "value": 12000 },
    { "ticker": "MSFT", "value":  8000 },
    { "ticker": "NVDA", "value":  5000 }
  ]
}

POST /evaluate

A PORTIQA avalia

70.000 ativos · 45 mercados

Cada posição resolvida e verificada em uma única passagem:

Saúde da alocação
Concentração setorial
Exposições a fatores
Aderência ao regime

Motor determinístico

Você recebe

78.1 Boa

Pontuação composta e status
Leitura setorial e de concentração
Plano de exposição + sugestões

200 OK · JSON

Construído como um instrumento.

A PORTIQA faz uma coisa só e faz com seriedade: transformar posições brutas em um veredicto sobre o qual você pode construir.

O mesmo motor em todos os planos

O preço muda quantas chamadas você faz — nunca a qualidade da resposta. O plano gratuito executa exatamente a mesma avaliação do plano mais alto.

Um veredicto, não um despejo de dados

O endpoint diz o que importa, não apenas o que existe. Pontuação, status e sugestões foram desenhados para serem lidos por pessoas e processados por máquinas.

Feito para quem constrói

JSON limpo e estável que se encaixa direto em painéis, produtos para clientes e ferramentas de assessoria. Um endpoint para integrar, um esquema para aprender.

Perguntas frequentes.

Mais profundidade na referência da API e nos guias de análise.

O que a API de análise de carteiras da PORTIQA retorna?

Um único POST para /evaluate retorna uma pontuação composta de 0 a 100, um status em linguagem clara, pontuações por componente de diversificação, risco, qualidade, sinal e tendência, métricas de concentração incluindo o peso máximo por posição e o número efetivo de posições, um plano de exposição-alvo com percentuais investido e em caixa, e uma lista de sugestões priorizadas.

Quantos ativos e mercados a PORTIQA cobre?

A PORTIQA reconcilia as posições com cerca de 70.000 ativos em 45 mercados, enriquecendo cada posição com dados de setor, fator e regime antes da pontuação. Você envia apenas o ticker e o valor de mercado; todo o resto é consultado automaticamente.

Existe um plano gratuito para a API de carteiras?

Sim. O plano gratuito inclui 5 avaliações por mês e roda o mesmo motor de avaliação de qualquer plano pago. O preço muda quantas chamadas você pode fazer, nunca a qualidade da análise.

Qual formato a API aceita?

JSON sobre HTTPS. Envie um array positions em que cada entrada tenha um ticker e um valor de mercado, com nível de risco e saldo em caixa opcionais. Autentique-se com um token bearer no cabeçalho Authorization. A resposta é em JSON.

A PORTIQA fornece recomendação de investimento?

Não. A PORTIQA retorna análise quantitativa com finalidade exclusivamente informativa. O resultado descreve a estrutura e as características de uma carteira e não constitui recomendação de investimento nem indicação de compra ou venda de qualquer valor mobiliário.