← Voltar ao guia de utilização
Exemplos de dados externos

Começar com dados públicos de teste

Se ligou a sua base de dados mas não tem dados para lá colocar, comece com um destes três. Todos são gratuitos e não precisam de chave API; basta seguir o script de carregamento e os valores a escolher no ecrã (tabela, colunas). O script está organizado por parsers, por isso, se quiser outra fonte, basta escrever mais uma entrada.

Antes de começar — Primeiro é preciso ligar a base de dados e criar uma conta só de leitura — Guia de integração do Supabase

Obter os coletores

Clone o repositório de fetchers na VPS (o servidor onde está o agente). A única dependência é pg. ★ O DATABASE_URL do .env deve ser uma conta com permissão de escrita. É normal a conta só de leitura rejeitar o INSERT; essa conta destina-se apenas à integração com a SoriTrading.

git clone https://github.com/Value-Connect-Global-Inc/soritrading-fetchers ~/soritrading-fetchers
cd ~/soritrading-fetchers && npm install
cp .env.example .env    # DATABASE_URL

https://github.com/Value-Connect-Global-Inc/soritrading-fetchers · Código aberto · uma pasta = um fetcher · registo cron automático

Os três abaixo são **exemplos para começar**. O repositório tem ainda VIX, volatilidade implícita cripto (DVOL), diferencial de taxas de longo/curto prazo, índice do dólar, capitalização das stablecoins, TVL DeFi, etc. — tudo gratuito e sem chave API. Execute `node run.mjs list` para ver a lista completa. As séries de mercado não têm valor nos feriados dos EUA (em falta, não 0), e o DVOL começa em março de 2021.

Como ler o ecrã de definições de dados

Gestão de agentes → escolher agente → separador Definições de dados. Só o próprio utilizador regista e elimina neste ecrã — a AI apenas lê os conjuntos de dados, e a cadeia de ligação nunca é colada no chat. O ecrã segue esta ordem, de cima para baixo.

  1. Integração de base de dados externa — Introduza um nome de ligação (ex.: main) e a cadeia de ligação. É guardada encriptada apenas no dispositivo do agente e nunca vai para o servidor. Ao abrir o ecrã, o agente lê automaticamente a lista de tabelas ([Verificar ligação] serve para voltar a ler).
  2. Tabelas e conjuntos de dados — Uma linha por tabela da base de dados: nome da tabela · número aproximado de linhas · comentário da tabela, e por baixo os conjuntos de dados que leem essa tabela.
  3. Nível de visibilidade para a AI (à direita da linha da tabela) — Privado (predefinição — a AI nem sabe que a tabela existe) · só nome · até colunas · até amostra · consulta permitida. Escolha e depois [Guardar visibilidade]. Os níveis colunas, amostra e consulta enviam dados reais para a AI, por isso não abra tabelas com dados pessoais. Só podem ser abertas tabelas do esquema public.
  4. Nomes dos conjuntos de dados (por baixo da linha da tabela) — É o valor que a estratégia chama com ctx.data(nome). [+ Adicionar conjunto de dados a partir desta tabela] → escolha o nome, a coluna de hora e a coluna de valor; a descrição é preenchida com o comentário da tabela e [Guardar] só fica disponível depois de [Testar] passar. Uma tabela pode ter vários nomes (para separar séries por corretora ou ativo com filtros, ou quando uma estratégia antiga usa outro nome). Indicador de estado: utilizável · por verificar · sem ligação. Ao clicar no indicador de tempo real ao lado, abrem-se as definições de despertar (poll·notify·redis) — na maioria dos casos, a predefinição basta.
  5. Conjuntos de dados calculados (SQL) — Valores que exigem cálculo, como médias móveis, valores desfasados ou combinações de várias tabelas. Como o SQL pode ler várias tabelas, estes ficam agrupados à parte e não sob uma tabela específica. A maioria dos cálculos pode ser feita no código da estratégia com dois ctx.data; use SQL apenas quando o cálculo precisar de todo o histórico (médias móveis, classificações). O SQL registado pelo método anterior pode ser tratado aqui com [SQL verificado] · [Eliminar] ou, se for simples, convertido em bloco para seleção de tabela.
  6. Conjuntos de dados cuja tabela não foi encontrada — Quando a tabela declarada não está na lista atual, o conjunto de dados não desaparece: fica aqui com o motivo — a lista de tabelas ainda não foi recebida (não significa que não exista) · a base de dados não tem essa tabela (renomeada ou eliminada) · este dispositivo não tem esse nome de ligação.
  7. Há dois âmbitos — O nível de visibilidade para a AI é guardado apenas no dispositivo que está aberto. Os conjuntos de dados aplicam-se a todos os dispositivos com o mesmo nome de ligação. Com vários dispositivos, a visibilidade escolhe-se em cada um.

1. Índice de medo e ganância

alternative.me

De 0 (medo extremo) a 100 (ganância extrema), uma vez por dia. Todo o período desde fevereiro de 2018. É um eixo de sentimento que o preço sozinho não mostra, por isso é o melhor primeiro teste.

node run.mjs fear-greed
Valores a escolher no ecrã de definições de dados ([+ Adicionar conjunto de dados a partir desta tabela] na linha da tabela)
Ligação: main   ·   Tabela: fear_greed
Nome: fg   ·   Coluna de hora: ts   ·   Coluna de valor: v
Depois de registar, basta dizer isto à AI
"Com o meu conjunto de dados fg, faz o backtest em binance BTC 1d de uma estratégia que compra com o índice de medo e ganância abaixo de 20 e vende acima de 60"

2. Hash rate da Bitcoin

blockchain.com

Um indicador da própria cadeia (TH/s). É um eixo diferente do preço, útil como filtro de regime. Os valores são grandes e a tendência é lenta, por isso é preferível usar o rácio face à média móvel em vez do valor bruto.

node run.mjs btc-hashrate
Valores a escolher no ecrã de definições de dados ([+ Adicionar conjunto de dados a partir desta tabela] na linha da tabela)
Ligação: main   ·   Tabela: btc_hashrate
Nome: hashrate   ·   Coluna de hora: ts   ·   Coluna de valor: v
Depois de registar, basta dizer isto à AI
"Acrescenta à minha estratégia um filtro que só compra enquanto o conjunto de dados hashrate estiver acima da média de 90 dias"

3. Taxa diretora dos EUA (para praticar)

FRED (DFF)

Taxa efetiva diária dos fundos federais. É o valor de referência dos filtros de regime macro. ★ Atenção: o mesmo valor já chega como indicador base base_fedfunds (ctx.data('base_fedfunds') — recolhido pelo agente a partir da FRED). Se introduzir o mesmo valor por dois caminhos, o resultado não permite distinguir qual foi usado, por isso use este apenas para praticar a integração.

node run.mjs fed-funds
Valores a escolher no ecrã de definições de dados ([+ Adicionar conjunto de dados a partir desta tabela] na linha da tabela)
Ligação: main   ·   Tabela: macro_fed_funds
Nome: dff   ·   Coluna de hora: ts   ·   Coluna de valor: v
Depois de registar, basta dizer isto à AI
"Mostra a lista de conjuntos de dados e verifica se dff está utilizável (para confirmar a integração)"

Recolha periódica (cron)

Regista no crontab cada fetcher com a periodicidade que declara. Voltar a executar não acumula linhas e as entradas cron que adicionou manualmente não são alteradas. Os registos ficam num ficheiro de registo por fetcher na pasta logs.

node run.mjs --install-cron
A saber
  • Recomenda-se epoch em segundos na coluna de hora (milissegundos e ISO também são reconhecidos automaticamente, e o campo tsUnit do relatório de verificação indica como foi lido).
  • Voltar a executar o script é seguro — sem duplicados, só os valores mais recentes são atualizados (upsert). Para dados novos, basta executar periodicamente.
  • 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.
  • Os backtests com dados externos também correm no agente — todos os backtests correm apenas no agente (o meu armazenamento).
  • As tabelas com nível de visibilidade definido ficam expostas à AI (os níveis colunas, amostra e consulta enviam dados reais) — não exponha tabelas com dados pessoais.