Ligar os seus dados com o Supabase
É a forma mais fácil de fazer com que as estratégias leiam, com ctx.data(), indicadores da sua própria base de dados (ex.: índice de medo e ganância, dados on-chain). O nível gratuito do Supabase é suficiente e a cadeia de ligação é guardada apenas no dispositivo do agente — o servidor soritrading não vê nem os dados nem a palavra-passe.
Criar um projeto Supabase
Crie um projeto gratuito em supabase.com. É preferível uma região próxima do agente (VPS).
Criar a tabela e inserir dados
Crie uma tabela de série temporal com o editor SQL ou o Table Editor. O requisito mínimo são duas colunas: hora (timestamp) e valor. Ex.: fear_greed(ts bigint, v numeric) — recomenda-se ts em epoch de segundos (milissegundos e ISO também são reconhecidos automaticamente). Se ainda não tiver dados para inserir, veja primeiro o que está abaixo — pode saltar este passo por completo.
Começar com dados públicos gratuitos é o caminho mais rápido. Disponibilizamos coletores de código aberto que preenchem a sua base de dados com indicadores como o índice de medo e ganância, o hash rate da Bitcoin, a taxa diretora dos EUA e o VIX — tudo gratuito e sem chave API. O coletor **cria ele próprio a tabela** (duas colunas, ts e v). Por isso, este passo 2 deixa de ter trabalho — um comando carrega os dados e outro regista o cron. ★ O carregamento usa uma conta com permissão de escrita. A conta só de leitura criada no passo 3 é uma conta separada, usada pelo agente para ler.
Ver o guia de carregamento de dados públicos →Criar uma conta só de leitura (importante)
A validação de estratégias só precisa de leitura. Cole o SQL abaixo no editor SQL do Supabase para criar uma função só de leitura — é a verdadeira linha de defesa para que, mesmo que a cadeia de ligação seja exposta, os dados não possam ser alterados.
create role readonly_bot login password 'substituir-por-palavra-passe-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;
Copiar a cadeia de ligação
No painel do projeto, abra Project Overview → Get connected, copie o URL em Direct e substitua apenas o nome da conta e a palavra-passe pelos criados no passo 3. No mesmo sítio aparece também o modo pooler. ★ O Supabase pode alterar os textos da interface — o próprio URL copiado indica o modo: · anfitrião db.ref-do-projeto.supabase.co (direto) → o nome da conta é simplesmente readonly_bot · anfitrião com pooler.supabase.com → o nome da conta é readonly_bot.ref-do-projeto (mantenha a ref após o ponto — se a remover, a ligação é recusada) ★ No nível gratuito, a ligação direta (5432) é só IPv6 — se o servidor do agente não tiver IPv6, use o URL em Session mode (pooler).
Ligar e deixar com a AI
Em Gestão de agentes → escolher agente → separador Definições de dados, introduza o nome da ligação (main) e o URL; a ligação é verificada de imediato. Depois, no mesmo ecrã, use [+ Adicionar conjunto de dados a partir desta tabela] na linha da tabela para escolher o nome, a coluna de hora e a coluna de valor, e depois [Testar] → [Guardar] (a AI apenas lê os conjuntos de dados). Depois de guardar, a AI pode criar uma estratégia com esse nome (ex.: ctx.data('fg')) e executar o backtest. Se não tiver dados para inserir, comece pelos exemplos de dados públicos em /guide/datasets (índice de medo e ganância, etc.).
- Os projetos gratuitos são suspensos após 1 semana sem utilização — a verificação do agente de 10 em 10 minutos conta como atividade, por isso normalmente ficam 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 incluem uma impressão digital dos dados (número de linhas, hash) — se o conteúdo da base de dados mudar, a impressão digital muda, e dois resultados com impressões digitais diferentes não foram obtidos nas mesmas condições.
Toda a documentação está aqui — Guia de utilização