Exemples open source pour bâtir sur l’API d’historique de trades de Veltra

Nous venons d’ouvrir le code de veltra-examples, un ensemble de projets courts, complets et prêts à copier-coller qui montrent comment bâtir de vrais outils sur l’API d’historique de trades de wallets de Veltra. Chacun se clone, s’exécute avec npm install && npm start et est pensé pour être repris tel quel dans votre propre projet.

L’idée est simple : l’API vous remet l’historique complet et déjà analysé des achats et ventes d’un wallet depuis un seul endpoint, si bien qu’au lieu de documentation vous pouvez lire un programme qui fonctionne et fait déjà ce que vous voulez.

Ce qu’il contient

• pnl-tracker : profits et pertes réalisés par token avec un prix de revient FIFO, un taux de réussite et les positions ouvertes. De la vraie comptabilité, pas une estimation du SOL entré et sorti.
• copy-trade-backtester : « si j’avais copié ce wallet, combien aurais-je gagné ? ». Rejoue l’historique d’un wallet avec un capital fini, une taille de position fixe et du slippage à chaque exécution.
• trade-scoring : un pipeline de machine learning qui extrait des variables de l’historique d’un wallet et entraîne un modèle à noter son niveau, avec un mode pour étiqueter vos propres wallets.
• wallet-watcher : interroge un wallet et vous alerte dès qu’il réalise un nouveau trade, dans votre terminal ou relayé vers un webhook Discord ou Slack.

Un endpoint, de nombreux outils

Chaque exemple repose sur un seul appel : GET /v1/wallets/{address}/history. Il renvoie chaque trade sous forme de ligne propre, avec le sens, le token, le mint, la valeur en SOL, la quantité de token, le DEX et l’horodatage, sans aucun décodage de transaction de votre côté. Ce seul flux du « qui a acheté et vendu quoi, pour combien, où et quand » suffit à calculer un prix de revient, backtester une stratégie de copie, entraîner un modèle de scoring ou surveiller une nouvelle activité.

Vous n’utilisez pas JavaScript ? Le dépôt fournit aussi un recueil de recettes curl couvrant le streaming, la pagination, le multichaîne, la gestion des erreurs et des one-liners jq, qui se transpose proprement dans n’importe quel langage.

Commencez par un seul appel

curl -N "https://veltrabot.com/v1/wallets/{address}/history" \
  -H "Authorization: Bearer YOUR_API_KEY"

Conçu pour être copié

• Chaque exemple est un dossier indépendant : copiez celui dont vous avez besoin, ignorez le reste. Aucun outillage de monorepo à apprendre.
• Chaque exemple fait un vrai travail sur les données au lieu de se contenter de réafficher la réponse de l’API.
• Les exemples orientés trading sont d’honnêtes simulations historiques, pas de l’exécution en direct, et disent clairement ce qu’ils modélisent et ce qu’ils ne modélisent pas.
• Chacun embarque ses propres tests, et la CI exécute la vérification de types et les tests pour tous.

Récupérer le code

Le code source complet est sur GitHub à l’adresse https://github.com/QuirkyTurtle11/veltra-examples, sous licence MIT. Prenez une API key : l’essai gratuit suffit à exécuter tous les exemples.