Heart · Super Tela

🤖 LLM Decision Engine

Motor alternativo que usa LLM (Gemini/Claude/GPT) para escolher picks em vez da formula VOLT. Quando ativo, VOLT continua calculando mas a LLM sobrescreve o confidence via JOIN com llm_picks_active.

Migrations: 0386-0392. Default seguro: decision_engine='volt' (desligado).

carregando...

Engine

—

Provider / Model

—

Picks (24h)

—

Ultimo Pick

—

Controle do motor

1-click para ativar/desativar. decision_engine='llm' faz o heart-agent escrever picks e o engine consumir via JOIN.

Configuracao

Provider / Model

Temperature

Min cash trigger (USD)

Cycle interval (segundos)

Versoes de Prompt

Ativar outra versao = rollback. Auto-gerador criara novas versoes pre-mercado.

carregando...

Picks ativos agora

Engine consome via JOIN em llm_picks_active. TTL = llm_pick_validity_seconds.

carregando...

Decisoes de hoje (com outcome)

Log completo — alimenta memoria 7d + auto-gerador.

carregando...

Memoria 7 pregoes (rolling)

Agregado diario — input do auto-gerador pre-mercado.

carregando...

Start here

Setup Wizard: configure identidade, execution_location, Bridge, loops e comando do Agent.

O universo-base global de símbolos fica na aba Trade Params. Ela alimenta a view universe_tradable, que sustenta o sistema quando o runner usa UNIVERSE_TRADABLE.

ClickHouse-only (db=aivest)

1) Identidade

Carrega state sem chamar o Bridge.

CH (read): aivest.heart_config_latest

user_id

account_id

Fonte: ClickHouse via /heart/console/accounts. Param ?accountId= tem prioridade.

2) Onde roda (execution_location)

Regra: vm ⇒ TWS obrigatório · local ⇒ Gateway obrigatório.

CH (write): aivest.heart_config_v1 · view: aivest.heart_config_latest

Local (Gateway)

Loop mínimo 30s (backend clampa com warning)

VM (TWS)

Sem mínimo de polling

Salva em /heart/console/heart-config.

—

3) Configurar Bridge

Nunca retorna apiKey após salva. Teste só roda no clique.

CH (write): aivest.ibkr_bridge_config_v1 · view: aivest.ibkr_bridge_config_latest

Bridge enabled

enabled só controla se existe chave; secrets não vazam.

bridgeMode

Pode ser sobrescrito pela policy (execution_location).

gateway_url

Obrigatório quando execution_location=local.

tws_url

Obrigatório quando execution_location=vm.

apiKey

—

—

4) Ligar Heart + Loops

Regra: NULL desabilita (zero hardcode). Local clampa >=30s.

CH (write): aivest.heart_config_v1 · view: aivest.heart_config_latest

O que cada campo faz

enabled: controla elegibilidade (se não for 1, a policy bloqueia execução).
execution_location: define o ambiente (local→Gateway / vm→TWS) e força o modo do Bridge.
agent_sync_interval_seconds: roda o sync pipeline (IBKR/estado → ClickHouse) quando habilitado.
agent_recon_interval_seconds: roda reconciliação de OCO/ordens quando habilitado.
agent_config_refresh_seconds: recarrega config/policy do CH periodicamente (mudanças entram "ao vivo").
agent_heartbeat_seconds: grava heartbeat/status do Agent em CH (pra tela "Agentes/Status" deixar de ficar null).
manage_tf_minutes: a cada N minutos roda o Heart runner (dry_run ou execute, dependendo da policy + runner_default_mode).

Heart enabled

manage_tf_minutes

Blank = NULL (não inventa default).

agent_sync_interval_seconds (DEPRECATED)

Deprecado: o loop agora e alinhado ao minuto via agent_loop_offset_seconds.

agent_loop_offset_seconds

Segundo exato do minuto em que o agent roda (0-59). Ex: 10 = roda em XX:XX:10. Candle fecha em :00, chega no CH em ~:03, agent le dado fresco em :10.

agent_recon_interval_seconds

agent_config_refresh_seconds

agent_heartbeat_seconds

—

—

5) Run Agent

Gera comandos prontos (copy). O browser não inicia o processo.

CH (agent writes): aivest.heart_agent_status_v1 (view: aivest.heart_agent_status_latest) · runs: aivest.heart_runs (view: aivest.heart_runs_latest)

Command

—

Sem segredos. Use placeholders e export em shell.

Agent status

—

—

Overview

Estado operacional derivado (policy, clamp, bloqueios) + resumo do status do agent.

Execution eligible

—

forcedBridgeMode: —

Blocked reasons

—

Warnings / clamps

—

Runtime status

Resumo amigável (sem dump de JSON). Ações só escrevem desired_state no ClickHouse.

Supervisor (VM)

Best-effort via /heart/console/vm/summary

—

desired_state

—

service

—

broker (TWS)

—

ibkr

—

ws latest

—

symbols

—

ts

—

Obs: em execution_location=vm, "IBKR OK" é via broker-service (TWS). O Gateway REST pode estar intencionalmente desabilitado na VM.

Agent (ClickHouse)

Heartbeat/status via /heart/console/agents

—

heartbeat

—

desired_state

—

loop_s

—

execution_location

—

bridge

—

eligible

—

Advanced (raw JSON)

Heart config (raw)

—

Bridge config (redacted)

—

Agent status (raw)

From heart_agent_status_latest

—

Runtime / Loops

Editar knobs sem defaults inventados. NULL desabilita.

O que é isto?

Tela avançada para editar diretamente a config do Heart no ClickHouse (CH-only). É o mesmo alvo do Wizard (Passo 4), mas aqui você pode carregar a config atual, editar e salvar apenas o que mudou.

CH (write): aivest.heart_config_v1 · view (read): aivest.heart_config_latest · endpoint: /heart/console/heart-config

Como salvar: sem "Load", campo vazio = no-change (patch). Com "Load", os campos vêm preenchidos (editar atual). "NULL" desabilita o knob.

Validação: intervalos devem ser >= 1 ou NULL. Em execution_location=local, backend clampa intervalos para >= 30s com warning.

O que cada campo faz:

enabled: controla elegibilidade (se não for 1, policy bloqueia execução).
execution_location: define o ambiente (local→Gateway / vm→TWS) e força o modo do bridge.
agent_sync_interval_seconds: roda o sync pipeline (IBKR/estado → ClickHouse) quando habilitado.
agent_recon_interval_seconds: roda reconciliação de OCO/ordens quando habilitado.
agent_config_refresh_seconds: recarrega config/policy do CH periodicamente (mudanças entram "ao vivo").
agent_heartbeat_seconds: grava heartbeat/status do agent em CH (pra tela "Agentes/Status" deixar de ficar null).
manage_tf_minutes: a cada N minutos roda o Heart runner (dry_run ou execute, dependendo da policy + runner_default_mode).
auto_liquidate: habilita/desabilita a regra de liquidação por fechamento.
close_offset_minutes: minutos antes do close para iniciar liquidação (só com auto_liquidate=1).
market_open_wait_minutes: bloqueia novas entradas nos primeiros N minutos após a abertura.

Dica: clique em Load para carregar/preencher a config atual e editar. Save só cria novo snapshot se algum campo mudou.

—

enabled

execution_location

agent_sync_interval_seconds (DEPRECATED)

Deprecado: o loop agora e alinhado ao minuto via agent_loop_offset_seconds.

agent_loop_offset_seconds

Segundo exato do minuto em que o agent roda (0-59). Candle fecha em :00, chega no CH em ~:03, agent le dado fresco em :10.

agent_recon_interval_seconds

agent_config_refresh_seconds

agent_heartbeat_seconds

manage_tf_minutes

auto_liquidate

close_offset_minutes

market_open_wait_minutes

vm_status_include_heart_agent_supervisor

vm_status_heart_agent_supervisor_required

Strategy Knobs

stage1_stop_move_r

Fator de R para mover stop no Stage 1 (default: 0.25)

early_trail_k_multiplier

Multiplicador k para trailing stages 0-2 (default: 1.5)

massive_env

Ambiente Massive quotes (prod / paper)

—

—

Bridge

Editar Bridge config (redacted) + testar sob demanda.

Policy pode forçar gateway/tws via execution_location.

CH (write): aivest.ibkr_bridge_config_v1 · view (read): aivest.ibkr_bridge_config_latest · endpoint: /heart/console/bridge-config

—

—

Bridge enabled

bridgeMode

gateway_url

tws_url

apiKey

—

—

Agentes

Dashboard multi-account (CH-only). Não chama Bridge no load.

Fonte: /heart/console/agents

Execute só habilita quando executionEligible=true + confirmação.

Account	Online	Loop(s)	Bridge	Eligible	Blocked reasons	Commands	Actions

Últimas respostas

—

Symbols

Overrides por símbolo (placeholder). Backend CRUD pode ser adicionado quando necessário.

Em breve

Sugestão: GET/POST /heart/console/overrides (CH-only) quando for ativar esta aba.

Realtime

Inspeção do Heart Realtime Guard (estado + ledger). Somente leitura (ClickHouse-only).

Guard state

Fonte: /heart/console/realtime/state

scopeType

scopeKey

limit

—

Events ledger

Fonte: /heart/console/realtime/events

symbol

since (ISO)

limit

—

Realtime (Config)

Configuracao do Realtime Guard — o componente que reage ao preco em tempo real, tick a tick. Ele monitora posicoes abertas e pode: (1) sair automaticamente quando stop/target e atingido, (2) mover o trailing stop para proteger lucro. Funciona independente do loop principal do Heart (que roda a cada 5s). Dados vem via HTTP tick-forward (Massive WS) ou WebSocket direto.

Sem defaults mágicos: NULL = desabilitado

—

Obrigatórios (quando enabled=1)

O Guard falha fechado quando habilitado e incompleto.

Ligado ⓘ enabled

realtime_mode ⓘ

realtime_manage_policy ⓘ

EXIT_AND_TRAIL exige realtime_min_move_bps.

realtime_price_source ⓘ

realtime_debounce_ms ⓘ

realtime_max_events_per_min ⓘ

realtime_exit_confirm_ticks ⓘ

realtime_min_move_bps ⓘ

Opcionais

Campos que ajudam debug/segurança, mas não são estritamente obrigatórios.

realtime_symbol_allowlist_mode ⓘ

Desligado ⓘ realtime_loopback_enabled (dry-run)

WS Feed (opcional)

Aparece quando realtime_mode=feed_ws ou quando feed é habilitado.

realtime_feed_enabled

realtime_feed_mode

realtime_feed_ws_url

realtime_feed_ws_headers_json

realtime_feed_ws_subscribe_json

realtime_feed_ws_heartbeat_seconds

realtime_feed_ws_max_msg_per_min

realtime_feed_ws_reconnect_enabled

realtime_feed_ws_reconnect_backoff_ms

realtime_feed_ws_reconnect_max_attempts

realtime_feed_symbol_field

realtime_feed_last_price_field

realtime_feed_timestamp_field (opcional)

realtime_feed_account_field (opcional)

API key fingerprint (read-only)

A key nunca volta em claro; só fingerprint.

API key (set/rotate)

Test Tick (HTTP)

Chama POST /heart/realtime/tick. Disponível quando realtime_mode=http.

symbol

source (TICK/MID/LAST)

price

bid

ask

last

—

Massive → Heart (tick-forward HTTP)

Knobs consumidos pelo massive_ws_ingestor para encaminhar ticks para POST /heart/realtime/tick (CH-only). Segredo fica fora do CH: ADMIN_API_TOKEN.

realtime_http_tick_forward_enabled

realtime_http_tick_forward_url

realtime_http_tick_forward_max_rps

realtime_http_tick_forward_max_per_symbol_per_sec

realtime_http_tick_forward_source

realtime_http_tick_forward_dry_run

dry_run

Obs: para o guard agir, normalmente realtime_enabled=1 e realtime_mode=http.

Debug

—

📸 Instagram

Conecta a conta do site e automatiza postagens (resumo diário, gráficos de trades).

—

Pré-requisitos (uma vez só): ① Instagram do site convertido em conta Business/Creator · ② vinculado a uma Página do Facebook · ③ app em developers.facebook.com com permissões instagram_basic + instagram_content_publish · ④ gerar token de longa duração (60 dias) e colar abaixo · ⑤ o IG User ID vem de GET /me/accounts → instagram_business_account.

IG User ID

Access Token

—

Automação

Horário do resumo

Resumo diário (0/1)

Gráficos de trades (0/1)

—

VOLT Config

Configuração do VOLT (ClickHouse-only). Endpoint: /heart/console/volt/config.

Obs: Load/Save aqui salvam somente o VOLT. Para configurar o Runner (universo, limites, preço mínimo), use a aba Runner no menu lateral.

⚰️ DEPRECATED (2026-08-25) — o min_confidence_to_act desta aba NÃO é lido pelo engine desde o VOLT v2.1. A régua REAL de confidence é volt_min_confidence_long/short no Heart Config (hoje 0.55, com late-gate 0.60 após 12:30 ET aplicado na view). Prova (24/08): entradas executadas com conf 0.589–0.687 — abaixo do 0.7 daqui. A tabela ibkr_volt_config segue viva por UM único knob: o toggle de persistência de quotes do ingestor (massive_quote_v1) — não dropar.

—

Como o Trade Heart usa o VOLT

Objetivo: evitar confusão de "campos duplicados" entre VOLT Config e Heart Config.

✅ RÉGUA REAL — o que decide entrada hoje

volt_min_confidence_long

—

volt_min_confidence_short

—

+ late-gate: régua sobe para 0.60 após 12:30 ET (aplicado na view VOLT_signals).

Onde editar: Heart Config → grupo Entry Gates.

⚙️ Suporte (Heart Config)

volt_signal_ttl_seconds = — · sinal mais velho que isso é ignorado

decision_tf_minutes = — · cadência de entradas

manage_tf_minutes = — · gestão de stops (0 = a cada tick ~5s, intencional)

—

⚰️ Legado — NÃO decide nada

min_confidence_to_act = — (ignorado pelo engine desde o VOLT v2.1)

max(min_confidence_to_act, volt_min_confidence)

A tabela ibkr_volt_config segue viva por 1 knob só: toggle de quotes do ingestor (massive_quote_v1) — não dropar.

Campos como auto_liquidate, close_offset_minutes, market_open_wait_minutes são do Heart Config (não do VOLT Config).

✅ VIVOS — os únicos 2 campos desta tabela que algo ainda lê

massive_quote_v1_enabled (0/1) ⓘ

Para "parar de gravar": selecione 0 e Save. Efeito em ~30s.

max_position_pct (%) ⓘ fallback

Fallback nocional; hoje o sizing real é risco-$ (risk_per_trade_usd) + teto 25% no Heart Config.

⚰️ MORTOS — nada lê; mantidos só por histórico (cada tooltip aponta o substituto VIVO)

enabled (0/1) ⓘ

skip_earnings_day (0/1) ⓘ

only_market_hours (0/1) ⓘ

exclude_earnings_from_baseline (0/1) ⓘ

rvol_threshold_normal ⓘ

rvol_threshold_earnings ⓘ

spike_window_minutes ⓘ

dip_window_minutes ⓘ

baseline_days ⓘ

spike_pct_min ⓘ

dip_pct_min ⓘ

min_confidence_to_act (0..1) ⓘ

sentiment_bullish_threshold ⓘ

sentiment_bearish_threshold ⓘ

default_stop_pct (%) ⓘ

Substituto: k_range/k_trend + suggested_stop_*.

target_risk_reward ⓘ

min_candle_coverage_rth ⓘ

Obs: a UI não faz probe no load da página — use Load para buscar os valores atuais. Save grava tudo, mas só os 2 campos VIVOS têm efeito.

—

Runner / Universo

Configura de onde vêm os símbolos, limites e filtros do Trade Heart.

Persistência: PUT /heart/config (ClickHouse: heart_config_latest).

runner_universe_mode

runner_max_symbols

runner_max_open_positions

runner_min_position_value

runner_min_symbol_price

runner_session_gate

runner_default_mode

Symbols (último dry-run)

VOLT

Sinais (ClickHouse). Endpoint: /heart/console/volt/signals.

Account ID

Max age (min)

Action filter

action_p1 filter

suggested_action_p1 filter

plan_type_p1 filter (exact)

—

VOLT Signals

—

Symbol	Fav	Action	Action_p1	Suggested_p1	Plan_p1	Data_status	Signal_type	Suggested_entry	Suggested_target	Day_open	Price	Age_min	Should_act	Conf	Conf_rt	C1_rvol	C2_news	C3_trend	C4_dir	C5_liq	N_gate	P1_boost	Ext_1d	Ext_2d	RVOL	Reason_codes_p1	Warning	Timestamp

—

Heart Config

Configuração do Heart (ClickHouse). Endpoint: /heart/config.

Trade Params (Global)

Configuração global da tabela trade_params. Define a base da view universe_tradable, ou seja, quais símbolos entram no universo-base do sistema.

Impacto direto: runner com runner_universe_mode=UNIVERSE_TRADABLE, filtros do universo-base e jobs/sinais que dependem desse universo. Operação update-only: sem insert manual e sem delete.

TC Force Entry — Configuração Centralizada

Todos os knobs do TC Force Entry em um só lugar: timer fixo, cascata dinâmica (early/late), regime detection (SPY EXTREME_UP/DOWN), capital allocation, fallbacks e a nova reserva de capital (mig 2026-05-14).

Esses knobs também aparecem em Heart Config, mas aqui ficam agrupados por categoria pra facilitar o trabalho do operador.

VOLT Formula Config

Parametros da formula de confianca VOLT (C1-C5, news gate, P1 boosts, extension gates).

P1 Scoring Config

Thresholds e pesos do scoring pre-market P1 (gates, liquidez, earnings, news, confianca).

P1 Volume Sub-model

RVOL, volume trend e volume spike scoring thresholds do P1.

P1 Price Sub-model

Price vs MA, streaks, momentum, gap e 10d magnitude scoring.

P1 Classification & Bounds

News classification, earnings output scores, bounds e reason thresholds.

IBKR Flex

Token, Query IDs e configuracao do Flex Web Service (execucoes historicas IBKR).

Schedules — Job Triggers

Horarios de disparo dos jobs (P1 Snapshot, News). Lidos pelo daemon aivest-job-scheduler na VM (cache 1h, tick 1min). Os GH Actions workflows ficam em workflow_dispatch apenas — esta UI eh a unica forma de agendar.

Carregando…

Runtime / Agent

Atalhos + status do agent (não depende do Bridge).

Overrides

CRUD por símbolo. Endpoint: /heart/overrides.

Guardrails

Contadores + limites. Endpoint: /heart/guardrails.

Auto-Tuner

Variaveis gerenciadas, safety bounds e historico de execucoes. Endpoint: /heart/console/auto-tuner/*.

Telemetry

Tail de runs/decisions. Endpoint: /heart/telemetry.

IBKR (live)

Read-only. Fonte: /heart/console/portfolio (via IBKR Bridge).

📊 Resumo da Conta IBKR

⏳

Carregando informações da conta...

Positions

—

PosId	AccountId	Symbol	Qty	Avg	Mkt	Value	UPnL

Open orders

—

OrderId	PosId	AccountId	Symbol	Side	Qty	Filled	Remaining	Type	Price	Status	Ações

🛒

Comprar/Vender Manual

Envie ordens diretamente ao IBKR (dispatcher centralizado).

Símbolo *

Quantidade *

Ação *

Tipo de Ordem

ℹ️ Como funciona

✓ COMPRAR: Cria posição nova ou adiciona à existente
✓ VENDER: Vende parte ou total de posição existente
✓ MARKET: Ordem executada ao preço de mercado atual
✓ LIMIT: Ordem executada apenas se atingir preço especificado
⚠️ Ordem será enviada IMEDIATAMENTE ao IBKR (TWS via broker-service)

⚡

Execução Rápida: Sistema usa dispatcher centralizado (mesma tecnologia do simulador de estratégias)

—

Status / Telemetry

Agent status e snapshot de eligibilidade. Auto-refresh é opcional.

Fonte: /heart/console/agent-status e /heart/console/state

Agent status

—

State (derived)

—

StockAIVest

Configuração do Trade Heart (E2E)

🤖 LLM Decision Engine

Start here

Overview

Runtime / Loops

Bridge

Agentes

Symbols

Realtime

Realtime (Config)

📸 Instagram

VOLT Config

Runner / Universo

VOLT

Heart Config

Trade Params (Global)

TC Force Entry — Configuração Centralizada

VOLT Formula Config

P1 Scoring Config

P1 Volume Sub-model

P1 Price Sub-model

P1 Classification & Bounds

IBKR Flex

Schedules — Job Triggers

Runtime / Agent

Overrides

Guardrails

Auto-Tuner

Telemetry

IBKR (live)

📊 Resumo da Conta IBKR

🏦 Informações da Conta

💰 Saldos e Valores

Comprar/Vender Manual

ℹ️ Como funciona

Status / Telemetry