Docs /Commentaries (AI)

Listar Commentaries

Análises geradas por IA explicando os movimentos do mercado. Escopo: index, ticker ou sector.

Commentaries são narrativas geradas diariamente via Claude Sonnet explicando por que índices, ativos ou setores se moveram. Cada registro traz um título, corpo (~150 palavras) e o número de fontes citadas.

Server URL https://api.redentia.com.br
GET/v1/market-commentaries
Authorization Required
Authorization Bearer <token>

Token de API obtido no dashboard em api.redentia.com.br/dashboard.

In: header
Query Parameters
scopestring

Tipo do escopo.

indextickersector
identifierstring

Identificador (ex: IBOV, PETR4, energy).

limitinteger default: 10

Número de commentaries.

curl -X GET "https://api.redentia.com.br/v1/market-commentaries?scope=index&identifier=IBOV&limit=10" \
  -H "Authorization: Bearer SEU_TOKEN"
{
  "data": [
    {
      "id": 1,
      "scope": "index",
      "identifier": "IBOV",
      "date": "2026-04-10",
      "change_percent": 1.23,
      "title": "Ibovespa renova recorde aos 197 mil pontos pela primeira vez",
      "commentary": "O Ibovespa engata o terceiro dia de recordes consecutivos na expectativa de negociações para um acordo de paz definitivo no Oriente Médio...",
      "context_data": {
        "name": "IBOV",
        "current_price": 197534.11,
        "previous_price": 195129.25,
        "change_percent": 1.23
      },
      "sources_count": 4,
      "model": "claude-sonnet-4-5"
    }
  ]
}

Query Parameters

scopestring

Tipo do escopo.

indextickersector
identifierstring

Identificador (ex: IBOV, PETR4, energy).

limitinteger default: 10

Número de commentaries.

Responses

200Sucesso
400Requisição malformada
401Não autenticado
403Plano insuficiente
404Recurso não encontrado
429Rate limit excedido
500Erro interno