← Torna a la guia d'ús
Guia de connexió a BD externa

Connecta les teves dades amb Supabase

És la manera més fàcil de fer que les estratègies llegeixin amb ctx.data() els indicadors de la teva pròpia base de dades (p. ex. l'índex de por i cobdícia o dades on-chain). N'hi ha prou amb el nivell gratuït de Supabase, i la cadena de connexió només es desa al dispositiu de l'agent — el servidor de soritrading no veu ni les dades ni la contrasenya.

Abans de començar — Cal que l'agent estigui instal·lat i vinculat (comprova-ho a la pantalla de gestió d'agents). Si les dades ja són en un altre Postgres, pots començar directament pel pas 3 (compte de només lectura).
1

Crea un projecte de Supabase

Crea un projecte gratuït a supabase.com. Convé una regió propera a l'agent (VPS).

2

Crea una taula i carrega-hi dades

Crea una taula de sèrie temporal amb l'editor SQL o el Table Editor. Com a mínim necessita dues columnes: una d'hora (timestamp) i una de valor. P. ex.: fear_greed(ts bigint, v numeric) — per a ts es recomana l'epoch en segons (també es reconeixen automàticament mil·lisegons i ISO). Si encara no tens dades per posar-hi, mira primer el que hi ha a sota — pots saltar-te aquest pas sencer.

No tens dades per carregar? — aquí s'encalla la majoria

El més ràpid és començar amb dades públiques gratuïtes. Oferim col·lectors de codi obert que omplen la teva BD amb indicadors com l'índex de por i cobdícia, la taxa de hash de Bitcoin, el tipus d'interès oficial dels EUA o el VIX — tots gratuïts i sense clau d'API. El col·lector **també crea la taula** (dues columnes, ts i v). Així aquest pas 2 desapareix — una ordre per carregar les dades i una altra per registrar-ho al cron. ★ Per carregar es fa servir un compte d'escriptura. El compte de només lectura que crearàs al pas 3 és un altre compte, el que fa servir l'agent per llegir.

Obre la guia per carregar dades públiques →
3

Crea un compte de només lectura (important)

Per validar estratègies només cal llegir. Enganxa l'SQL de sota a l'editor SQL de Supabase per crear un rol de només lectura — és la defensa real perquè, encara que es filtri la cadena de connexió, no es puguin modificar les dades.

create role readonly_bot login password 'substitueix-per-una-contrasenya-forta';
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

Copia la cadena de connexió

Al tauler del projecte, obre Project Overview → Get connected, copia l'URL de l'apartat Direct i canvia només l'usuari i la contrasenya pels que has creat al pas 3. Al mateix lloc també hi apareixen les opcions de pooler. ★ Supabase pot canviar els textos de la interfície — l'URL copiat ja et diu quin mode és: · si l'amfitrió és db.ref del projecte.supabase.co (directe) → l'usuari és simplement readonly_bot · si l'amfitrió conté pooler.supabase.com → l'usuari és readonly_bot.ref del projecte (mantén la ref després del punt — si l'esborres, es rebutja la connexió) ★ Al nivell gratuït, la connexió directa (5432) només és IPv6 — si el servidor de l'agent no té IPv6, fes servir l'URL de Session mode (pooler).

5

Connecta-ho i deixa-ho en mans de la IA

A Gestió d'agents → tria un agent → pestanya Configuració de dades, introdueix el nom de connexió (main) i l'URL, i la connexió es verifica a l'instant. Després, a la mateixa pantalla, fes servir [+ Afegeix un conjunt de dades d'aquesta taula] a la fila de la taula per triar el nom, la columna d'hora i la columna de valor, i prem [Prova] → [Desa] (la IA només llegeix els conjunts de dades). Un cop desat, la IA pot crear una estratègia amb aquest nom (p. ex. ctx.data('fg')) i fins i tot executar-ne el backtest. Si no tens dades per posar-hi, comença amb els exemples de dades públiques de /guide/datasets (índex de por i cobdícia, etc.).

Cal saber
  • Els projectes gratuïts es posen en pausa després d'una setmana sense ús — la verificació de l'agent cada 10 minuts compta com a activitat i normalment els manté actius.
  • L'actualització en temps real (mode notify) només funciona amb l'URL de Session mode (l'agrupació de Transaction mode no admet LISTEN).
  • Els resultats de backtest porten una empremta de les dades (nombre de files · hash) — si el contingut de la BD canvia, l'empremta canvia, i dos resultats amb empremtes diferents no tenen les mateixes condicions.