Commencer avec des données publiques de test
Vous avez connecté votre DB mais n'avez rien à y mettre ? Commencez par l'un de ces trois exemples. Tous sont gratuits, sans clé API, avec le script de chargement et les valeurs exactes à choisir à l'écran (table, colonnes). Le script est organisé autour d'une table de parseurs — ajouter votre propre source ne demande qu'une entrée de plus.
Récupérer les collecteurs
Clonez le dépôt des fetchers sur le VPS (le serveur où tourne l'agent). La seule dépendance est pg. ★ Le DATABASE_URL du .env doit être un compte en écriture. Il est normal qu'un compte en lecture seule refuse l'INSERT ; ce compte-là sert uniquement à l'intégration 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 · Open source · un dossier = un fetcher · inscription cron automatique
Les trois ci-dessous sont des **exemples de départ**. Le dépôt contient aussi le VIX, la volatilité implicite crypto (DVOL), l'écart de taux long/court, l'indice du dollar, la capitalisation des stablecoins, le TVL DeFi, etc. — tous gratuits, sans clé. `node run.mjs list` affiche la liste complète. Les séries de marché n'ont pas de valeur les jours fériés américains (absente, pas zéro), et DVOL commence en mars 2021.
Lire l'écran des paramètres de données
Gestion des agents → choisir un agent → onglet Paramètres de données. Vous seul ajoutez ou supprimez des jeux de données, sur cet écran — l'IA ne fait que les lire, et les chaînes de connexion ne doivent jamais être collées dans le chat. De haut en bas, l'écran comporte ces parties.
- Connexion à une DB externe — Saisissez un nom de connexion (ex. main) et la chaîne de connexion. Elle est stockée chiffrée uniquement sur l'appareil de l'agent et ne va jamais au serveur. À l'ouverture de l'écran, l'agent lit automatiquement la liste des tables ([Vérifier la connexion] pour la relire).
- Tables et jeux de données — Une ligne par table de la DB : nom de la table · nombre approximatif de lignes · commentaire de la table — et, en dessous, les jeux de données qui lisent cette table.
- Visibilité pour l'IA (à droite de la ligne de table) — Privé (par défaut — l'IA ignore même l'existence de la table) · nom seul · colonnes · échantillon · requête autorisée. Choisissez, puis [Enregistrer la visibilité]. Les niveaux colonnes, échantillon et requête envoient des données réelles à l'IA : n'ouvrez pas de tables contenant des données personnelles. Seules les tables du schéma public peuvent être ouvertes.
- Noms des jeux de données (sous la ligne de table) — La valeur qu'une stratégie appelle avec ctx.data(nom). [+ Ajouter un jeu de données depuis cette table] → choisissez un nom, une colonne horaire et une colonne de valeur ; la description est préremplie avec le commentaire de la table, et [Enregistrer] ne se déverrouille qu'après la réussite de [Tester]. Une table peut porter plusieurs noms (un filtre par série de plateforme ou de symbole, ou une ancienne stratégie qui utilise un autre nom). Badge d'état : utilisable · non vérifié · non connecté. Cliquez sur le badge temps réel à côté pour afficher les réglages de réveil (poll · notify · redis) — la valeur par défaut convient dans la plupart des cas.
- Jeux de données calculés (SQL) — Valeurs qui nécessitent un calcul — moyennes mobiles, valeurs décalées, combinaison de plusieurs tables. Le SQL pouvant lire plusieurs tables, ces jeux sont regroupés à part, pas sous une table. La plupart des calculs peuvent se faire dans le code de la stratégie avec deux appels ctx.data ; n'utilisez le SQL que si le calcul nécessite tout l'historique (moyennes mobiles, rangs). Les déclarations SQL de l'ancien format se trouvent aussi ici : [SQL vérifié] · [Supprimer], ou conversion en masse des plus simples vers la sélection par table.
- Jeux de données dont la table est introuvable — Quand une table déclarée n'est pas dans la liste actuelle, le jeu de données ne disparaît pas — il reste ici avec la raison : liste des tables pas encore reçue (cela ne veut pas dire absente) · la DB n'a pas cette table (renommée ou supprimée) · cet appareil n'a pas ce nom de connexion.
- Deux portées — La visibilité pour l'IA n'est enregistrée que sur l'appareil actuellement ouvert. Les jeux de données s'appliquent à tous les appareils ayant le même nom de connexion. Avec plusieurs appareils, choisissez la visibilité sur chacun.
1. Indice Fear & Greed
alternative.meDe 0 (peur extrême) à 100 (avidité extrême), une fois par jour, historique complet depuis février 2018. Un axe de sentiment que le prix seul ne montre pas — le meilleur premier test.
node run.mjs fear-greed
Connexion: main · Table: fear_greed Nom: fg · Colonne horaire: ts · Colonne de valeur: v
2. Hashrate du bitcoin
blockchain.comUn indicateur propre à la chaîne (TH/s), sur un autre axe que le prix, utile comme filtre de régime. Les valeurs sont grandes et évoluent lentement : un ratio à la moyenne mobile fonctionne mieux que la valeur brute.
node run.mjs btc-hashrate
Connexion: main · Table: btc_hashrate Nom: hashrate · Colonne horaire: ts · Colonne de valeur: v
3. Taux directeur américain (exercice)
FRED (DFF)Taux effectif des fonds fédéraux, quotidien. La valeur type pour un filtre de régime macro. ★ Attention : la même valeur arrive déjà comme indicateur de base base_fedfunds (ctx.data('base_fedfunds') — collecté par votre agent depuis FRED). Injecter la même valeur par deux chemins rend ambigu, dans les résultats, celui qui a été utilisé ; ne l'utilisez donc que pour vous exercer à l'intégration.
node run.mjs fed-funds
Connexion: main · Table: macro_fed_funds Nom: dff · Colonne horaire: ts · Colonne de valeur: v
Collecte périodique (cron)
Inscrit chaque fetcher dans crontab selon sa propre périodicité. Le relancer ne cumule pas les lignes, et vos entrées cron personnelles ne sont pas touchées. Les journaux sont écrits dans un fichier par fetcher dans le dossier logs.
node run.mjs --install-cron
- Pour la colonne horaire, l'epoch en secondes est recommandé (millisecondes et ISO sont aussi reconnus automatiquement ; la manière dont elle a été lue figure dans le champ tsUnit du rapport de vérification).
- Relancer le script est sans risque — il fait un upsert : pas de doublons, seules les valeurs plus récentes changent. Relancez-le périodiquement pour avoir des données fraîches.
- 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.
- Les backtests utilisant des données externes tournent aussi sur l'agent — tous les backtests tournent uniquement sur l'agent (mon stockage).
- Les tables auxquelles vous donnez un niveau de visibilité sont exposées à l'IA (les niveaux colonnes, échantillon et requête envoient des données réelles) — n'exposez pas de tables contenant des données personnelles.
Toute la documentation est ici — Guide