Connecter vos données avec Supabase
Le moyen le plus simple de faire lire à vos stratégies, via ctx.data(), des indicateurs de votre propre base (indice Fear & Greed, données on-chain, etc.). L'offre gratuite de Supabase suffit, et la chaîne de connexion n'est stockée que sur l'appareil de l'agent — le serveur soritrading ne voit ni vos données ni votre mot de passe.
Créer un projet Supabase
Créez un projet gratuit sur supabase.com. Choisissez de préférence une région proche de votre agent (VPS).
Créer une table et charger des données
Créez une table de série temporelle avec l'éditeur SQL ou le Table Editor. Le minimum : une colonne horaire (horodatage) et une colonne de valeur. Ex. : fear_greed(ts bigint, v numeric) — ts en epoch secondes recommandé (millisecondes et ISO sont aussi reconnus automatiquement). Si vous n'avez pas encore de données à charger, voyez d'abord ci-dessous — vous pouvez sauter cette étape entièrement.
Le plus rapide est de commencer avec des données publiques gratuites. Nous fournissons des collecteurs open source qui remplissent votre DB avec l'indice Fear & Greed, le hashrate du bitcoin, le taux directeur américain, le VIX, etc. — tous gratuits, sans clé API. Le collecteur **crée aussi la table pour vous** (colonnes ts et v). Cette étape 2 disparaît donc : une commande pour charger, une de plus pour inscrire le cron. ★ Le chargement utilise un compte en ÉCRITURE. Le compte en lecture seule créé à l'étape 3 est un compte distinct, utilisé par l'agent pour lire.
Voir le guide des données publiques →Créer un compte en LECTURE SEULE (important)
La vérification des stratégies ne demande que la lecture. Collez le SQL ci-dessous dans l'éditeur SQL de Supabase pour créer un rôle en lecture seule — c'est la vraie ligne de défense : même si la chaîne de connexion fuit, les données ne peuvent pas être modifiées.
create role readonly_bot login password 'remplacez-par-un-mot-de-passe-fort'; 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;
Copier la chaîne de connexion
Dans le tableau de bord du projet, ouvrez Project Overview → Get connected, copiez l'URL sous Direct, puis remplacez uniquement le nom d'utilisateur et le mot de passe par ceux créés à l'étape 3. Les variantes pooler apparaissent au même endroit. ★ Supabase peut renommer ces libellés — l'URL copiée indique elle-même le mode : · hôte db.réf-de-votre-projet.supabase.co (direct) → l'utilisateur est simplement readonly_bot · l'hôte contient pooler.supabase.com → l'utilisateur est readonly_bot.réf-de-votre-projet (gardez la réf après le point — la retirer provoque un refus de connexion) ★ Sur l'offre gratuite, la connexion directe (5432) est IPv6 uniquement — si le serveur de l'agent n'a pas d'IPv6, utilisez l'URL Session mode (pooler).
Connecter, puis confier à l'IA
Gestion des agents → choisir un agent → onglet Paramètres de données : saisissez un nom de connexion (main) et l'URL, la connexion est vérifiée immédiatement. Puis, sur le même écran, utilisez [+ Ajouter un jeu de données depuis cette table] sur la ligne de la table pour choisir un nom, une colonne horaire et une colonne de valeur, puis [Tester] → [Enregistrer] (l'IA ne fait que lire les jeux de données). Une fois enregistré, l'IA peut écrire une stratégie avec ce nom (ex. ctx.data('fg')) et lancer le backtest. Pas encore de données ? Commencez avec les exemples de données publiques de /guide/datasets (indice Fear & Greed, etc.).
- Les projets gratuits se mettent en pause après une semaine d'inactivité — la vérification de l'agent toutes les 10 minutes compte généralement comme activité et le maintient éveillé.
- Les mises à jour en temps réel (mode notify) ne fonctionnent qu'avec une URL en Session mode (le pooling en Transaction mode ne prend pas en charge LISTEN).
- Les résultats de backtest portent une empreinte des données (nombre de lignes, hash) — si le contenu de la DB change, l'empreinte change, et deux résultats aux empreintes différentes n'ont pas été obtenus dans les mêmes conditions.
Toute la documentation est ici — Guide