← Voltar para a ajuda
Guia de integração com BD externo

Integrar seus dados com o Supabase

O caminho mais fácil para a estratégia ler indicadores do seu próprio banco de dados (ex.: índice de medo e ganância, dados on-chain) com ctx.data(). O nível gratuito do Supabase basta, e a string de conexão fica salva só no dispositivo do agente — o servidor da soritrading não vê nem os dados nem a senha.

Antes de começar — O agente precisa estar instalado e pareado (confira na tela Gerenciar agentes). Se seus dados já estão em outro Postgres, comece direto pelo passo 3 (conta somente leitura).
1

Criar um projeto no Supabase

Crie um projeto gratuito em supabase.com. Prefira uma região próxima do agente (VPS).

2

Criar a tabela e inserir os dados

Crie uma tabela de série temporal pelo SQL Editor ou pelo Table Editor. O mínimo são duas colunas: uma de horário (timestamp) e uma de valor. Ex.: fear_greed(ts bigint, v numeric) — recomenda-se ts em epoch de segundos (milissegundos e ISO também são detectados automaticamente). Se ainda não tem dados para colocar, veja primeiro o bloco abaixo — dá para pular este passo inteiro.

Não tem dados para colocar? — é aqui que a maioria trava

Começar com dados públicos gratuitos é o caminho mais rápido. Oferecemos coletores de código aberto que preenchem seu BD com indicadores como índice de medo e ganância, hashrate do bitcoin, taxa básica de juros dos EUA e VIX — todos gratuitos e sem chave de API. O coletor **cria a tabela para você** (colunas ts e v). Com isso, este passo 2 desaparece — um comando carrega os dados e mais um registra no cron. ★ A carga usa uma conta com permissão de ESCRITA. A conta somente leitura criada no passo 3 é outra, usada pelo agente para ler.

Ver o guia de dados públicos →
3

Criar uma conta SOMENTE LEITURA (importante)

Para validar estratégias só é preciso leitura. Cole o SQL abaixo no SQL Editor do Supabase para criar uma role somente leitura — é a verdadeira linha de defesa para que, mesmo se a string de conexão vazar, ninguém consiga alterar os dados.

create role readonly_bot login password 'troque-por-uma-senha-forte';
grant usage on schema public to readonly_bot;
grant select on all tables in schema public to readonly_bot;
alter default privileges in schema public grant select on tables to readonly_bot;
4

Copiar a string de conexão

No painel do projeto, abra Project Overview → Get connected, copie a URL do item Direct e troque apenas o usuário e a senha pelos criados no passo 3. As opções de pooler aparecem no mesmo lugar. ★ O Supabase pode mudar os textos da interface — a própria URL copiada diz qual modo é: · host db.REF_DO_PROJETO.supabase.co (direto) → o usuário é só readonly_bot · host com pooler.supabase.com → o usuário é readonly_bot.REF_DO_PROJETO (mantenha o ref depois do ponto — sem ele a conexão é recusada) ★ No nível gratuito, a conexão direta (5432) é só IPv6 — se o servidor do agente não tiver IPv6, use a URL em Session mode (pooler).

5

Integrar e deixar com a IA

Em Gerenciar agentes → escolha o agente → aba Configurações de dados, informe o nome da conexão (main) e a URL — a conexão é verificada na hora. Depois, na mesma tela, use [+ Adicionar dataset desta tabela] na linha da tabela para escolher nome, coluna de horário e coluna de valor, e clique em [Testar] → [Salvar] (a IA apenas lê os datasets). Depois de salvo, a IA pode criar uma estratégia com esse nome (ex.: ctx.data('fg')) e rodar o backtest. Se não tem dados para colocar, comece pelos exemplos de dados públicos em /guide/datasets (índice de medo e ganância etc.).

Bom saber
  • Projetos gratuitos são pausados após cerca de 1 semana sem uso — a verificação do agente a cada 10 minutos conta como atividade e normalmente os mantém ativos.
  • A atualização em tempo real (modo notify) só funciona com URL em Session mode (o pooling em Transaction mode não suporta LISTEN).
  • Os resultados de backtest guardam uma impressão digital dos dados (número de linhas, hash) — se o conteúdo do BD mudar, a impressão digital muda, e dois resultados com impressões diferentes não rodaram nas mesmas condições.