← Volver a la guía de uso
Ejemplos de datos externos

Empezar con datos públicos de prueba

Si ha conectado su BD pero no tiene datos que meter, empiece con uno de estos tres. Todos son gratuitos y sin clave API, e incluyen el script de carga y los valores (tabla, columnas) que debe elegir en pantalla. El script funciona añadiendo parsers, así que si quiere otra fuente basta con escribir una entrada más.

Antes de empezar — Primero hay que conectar la BD y crear una cuenta de solo lectura — Guía de integración con Supabase

Obtener los fetchers

Clone el repositorio de fetchers en el VPS (el servidor donde está el agente). La única dependencia es pg. ★ El DATABASE_URL de .env debe ser una cuenta con escritura. Es normal que una cuenta de solo lectura rechace el INSERT; esa cuenta es solo para la integración con 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 abierto · una carpeta = un fetcher · registro automático en cron

Los tres de abajo son **ejemplos para empezar**. El repositorio incluye además VIX, la volatilidad implícita de cripto (DVOL), el diferencial de tipos largo-corto, el índice del dólar, la capitalización de stablecoins, el TVL de DeFi y más, todos gratuitos y sin clave — vea la lista completa con `node run.mjs list`. Los datos de mercado no tienen valor en los festivos de EE. UU. (falta el dato, no es 0) y DVOL empieza en marzo de 2021.

Cómo leer la pantalla de ajustes de datos

Gestión de agentes → elegir agente → pestaña Ajustes de datos. Solo usted registra y elimina en esta pantalla — la IA solo lee los conjuntos de datos y la cadena de conexión nunca se pega en el chat. De arriba abajo, la pantalla tiene este orden.

  1. Conexión con BD externa — Introduzca un nombre de conexión (p. ej. main) y la cadena de conexión. Se guarda cifrada solo en el equipo del agente y no va al servidor. Al abrir la pantalla, el agente lee automáticamente la lista de tablas ([Comprobar conexión] sirve para volver a leerla).
  2. Tablas y conjuntos de datos — Una fila por cada tabla de la BD: nombre de la tabla · número aproximado de filas · comentario de la tabla, y debajo los conjuntos de datos que leen esa tabla.
  3. Nivel de visibilidad para la IA (a la derecha de la fila de la tabla) — Privado (por defecto — la IA ni siquiera sabe que existe la tabla) · solo nombre · con columnas · con muestra · consulta permitida. Elija y pulse [Guardar visibilidad]. Los niveles de columnas, muestra y consulta envían datos reales a la IA, así que no abra tablas con datos personales. Solo se pueden abrir tablas del esquema public.
  4. Nombres de conjuntos de datos (debajo de la fila de la tabla) — Es el valor al que la estrategia llama con ctx.data(nombre). [+ Añadir conjunto de datos con esta tabla] → elija nombre, columna de hora y columna de valor; la descripción se rellena con el comentario de la tabla y [Guardar] solo se habilita tras superar [Probar]. Una tabla puede tener varios nombres (para separar series por exchange o símbolo con filtros, o cuando una estrategia antigua usa otro nombre). Distintivo de estado: utilizable · sin comprobar · sin conexión. Al pulsar el distintivo de tiempo real de al lado se despliegan los ajustes de activación (poll · notify · redis) — en la mayoría de casos basta con los valores por defecto.
  5. Conjuntos de datos calculados (SQL) — Valores que requieren cálculo, como medias móviles, valores retardados o combinaciones de varias tablas. Como el SQL puede leer varias tablas, se agrupan aparte, no bajo una tabla concreta. La mayoría de cálculos se pueden hacer en el código de la estrategia con dos ctx.data, así que use SQL solo cuando el cálculo necesite todo el historial (medias móviles, rankings). Los SQL registrados con el método anterior también están aquí: [SQL revisado] · [Eliminar], o conviértalos en bloque a selección de tabla si son sencillos.
  6. Conjuntos de datos cuya tabla no se encontró — Cuando la tabla declarada no está en la lista actual, el conjunto de datos no desaparece: queda aquí con el motivo — aún no se ha recibido la lista de tablas (no significa que no exista) · esa BD no tiene la tabla (renombrada o eliminada) · este equipo no tiene ese nombre de conexión.
  7. Hay dos ámbitos — El nivel de visibilidad para la IA se guarda solo en el equipo que tiene abierto. Los conjuntos de datos se aplican a todos los equipos con el mismo nombre de conexión. Si tiene varios equipos, elija la visibilidad en cada uno.

1. Índice de miedo y codicia

alternative.me

De 0 (miedo extremo) a 100 (codicia extrema), una vez al día. Historial completo desde febrero de 2018. Es un eje de sentimiento que el precio por sí solo no muestra, así que es la mejor primera prueba.

node run.mjs fear-greed
Valores a elegir en la pantalla de ajustes de datos ([+ Añadir conjunto de datos con esta tabla] en la fila de la tabla)
Conexión: main   ·   Tabla: fear_greed
Nombre: fg   ·   Columna de hora: ts   ·   Columna de valor: v
Tras registrarlo, basta con decirle esto a la IA
«Con mi conjunto de datos fg, haz un backtest de binance BTC 1d comprando con el índice de miedo y codicia por debajo de 20 y vendiendo por encima de 60»

2. Tasa de hash de bitcoin

blockchain.com

Un indicador propio de la cadena (TH/s). Es un eje distinto del precio, útil como filtro de régimen. Los valores son grandes y la tendencia suave, así que funciona mejor como ratio respecto a su media móvil que en bruto.

node run.mjs btc-hashrate
Valores a elegir en la pantalla de ajustes de datos ([+ Añadir conjunto de datos con esta tabla] en la fila de la tabla)
Conexión: main   ·   Tabla: btc_hashrate
Nombre: hashrate   ·   Columna de hora: ts   ·   Columna de valor: v
Tras registrarlo, basta con decirle esto a la IA
«Añade a mi estrategia actual un filtro que solo compre cuando el conjunto de datos hashrate esté por encima de su media de 90 días»

3. Tipo de interés oficial de EE. UU. (práctica)

FRED (DFF)

Tipo efectivo diario de los fondos federales. Es el valor típico para filtrar el régimen macroeconómico. ★ Atención: el mismo valor ya llega como indicador base base_fedfunds (ctx.data('base_fedfunds') — lo recopila el agente desde FRED). Si mete el mismo valor por dos vías, en el resultado no se distingue cuál se usó, así que úselo solo para practicar la integración.

node run.mjs fed-funds
Valores a elegir en la pantalla de ajustes de datos ([+ Añadir conjunto de datos con esta tabla] en la fila de la tabla)
Conexión: main   ·   Tabla: macro_fed_funds
Nombre: dff   ·   Columna de hora: ts   ·   Columna de valor: v
Tras registrarlo, basta con decirle esto a la IA
«Muéstrame la lista de conjuntos de datos y comprueba si dff está utilizable (solo para confirmar la integración)»

Recopilación periódica (cron)

Registra en crontab cada fetcher con el periodo que declara. Volver a ejecutarlo no acumula líneas y no toca los cron que haya añadido usted. Los registros quedan en un archivo por fetcher dentro de la carpeta logs.

node run.mjs --install-cron
A tener en cuenta
  • Para la columna de hora se recomienda epoch en segundos (también se reconocen automáticamente milisegundos e ISO, y cómo se leyó queda en tsUnit del informe de verificación).
  • Es seguro volver a ejecutar el script — solo actualiza los valores más recientes, sin duplicados (upsert). Para tener datos nuevos, vuelva a ejecutarlo periódicamente.
  • Los resultados de backtest guardan una huella de los datos (número de filas, hash) — si cambia el contenido de la BD, cambia la huella, y dos resultados con huellas distintas no se hicieron en las mismas condiciones.
  • Los backtests que usan datos externos también se ejecutan en el agente — todos los backtests se ejecutan solo en el agente (mi almacén).
  • Las tablas a las que asigne un nivel de visibilidad quedan expuestas a la IA (los niveles de columnas, muestra y consulta envían datos reales) — no exponga tablas con datos personales.