← Retour au guide d'utilisation
Guide d'intégration de DB externe

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.

Avant de commencer — Votre agent doit être installé et appairé (vérifiez sur la page Gestion des agents). Si vos données sont déjà dans un autre Postgres, appliquez directement à partir de l'étape 3 (compte en lecture seule).
1

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

2

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.

Pas de données à charger ? — c'est là que la plupart bloquent

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

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

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

5

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

Bon à savoir
  • 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.