Ejemplos open source para construir sobre la API de historial de trades de Veltra
Cuatro ejemplos ejecutables para la API de historial de trades de Veltra: seguimiento de PnL, backtesting de copy-trading, puntuación de wallets con ML y alertas de nuevos trades. Copia, ejecuta, publica.
Acabamos de liberar veltra-examples, un conjunto de proyectos pequeños, completos y listos para copiar y pegar que muestran cómo construir herramientas reales sobre la API de historial de trades de wallets de Veltra. Cada uno se clona, se ejecuta con npm install && npm start y está pensado para llevártelo tal cual a tu propio proyecto.
La idea es sencilla: la API te entrega el historial completo y ya parseado de compras y ventas de una wallet desde un solo endpoint, así que en lugar de documentación puedes leer un programa funcionando que ya hace lo que quieres.
Qué incluye
pnl-tracker: beneficio y pérdida realizados por token con coste base FIFO, tasa de acierto y posiciones abiertas. Contabilidad real, no una estimación de SOL que entra y SOL que sale.copy-trade-backtester: "si hubiera copiado esta wallet, ¿cuánto habría ganado?". Reproduce el historial de una wallet con un capital finito, un tamaño de posición fijo y slippage en cada ejecución.trade-scoring: un pipeline de machine learning que extrae características del historial de una wallet y entrena un modelo para puntuar lo hábil que es, con un modo para etiquetar tus propias wallets.wallet-watcher: consulta una wallet y recibe una alerta en cuanto hace un nuevo trade, en tu terminal o reenviada a un webhook de Discord o Slack.
Un endpoint, muchas herramientas
Todos los ejemplos se apoyan en una sola llamada: GET /v1/wallets/{address}/history. Devuelve cada trade como una fila limpia (lado, token, mint, valor en SOL, cantidad de token, DEX y timestamp) sin que tengas que decodificar transacciones. Ese único flujo de "quién compró y vendió qué, por cuánto, dónde y cuándo" basta para calcular el coste base, hacer backtesting de una estrategia de copia, entrenar un modelo de puntuación o vigilar nueva actividad.
¿No usas JavaScript? El repositorio también incluye un recetario de curl (streaming, paginación, multichain, manejo de errores y one-liners con jq) que se traduce sin problemas a cualquier lenguaje.
Empieza con una sola llamada
curl -N "https://veltrabot.com/v1/wallets/{address}/history" \
-H "Authorization: Bearer YOUR_API_KEY"Hecho para copiarse
- Cada ejemplo es una carpeta independiente: copia el que necesites e ignora el resto. No hay herramientas de monorepo que aprender.
- Cada ejemplo hace trabajo real sobre los datos en lugar de limitarse a reimprimir la respuesta de la API.
- Los ejemplos de estilo trading son simulaciones históricas honestas, no ejecución en vivo, y dicen con claridad qué modelan y qué no.
- Cada uno incluye sus propios tests, y CI ejecuta typecheck y tests para todos ellos.
Consigue el código
El código fuente completo está en GitHub, en https://github.com/QuirkyTurtle11/veltra-examples, con licencia MIT. Consigue una API key: la prueba gratuita basta para ejecutar todos los ejemplos.