← Voltar ao guia de utilização
Guia de integração de base de dados externa

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.

Antes de começar — O agente tem de estar instalado e emparelhado (verifique no ecrã de gestão de agentes). Se os dados já estiverem noutro Postgres, aplica-se tal e qual a partir do passo 3 (conta só de leitura).
1

Criar um projeto Supabase

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

2

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.

Não tem dados para inserir? — é aqui que a maioria fica bloqueada

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 →
3

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;
4

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).

5

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.).

A saber
  • 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.