Exemplos open source para construir sobre a API de histórico de trades da Veltra

Acabamos de abrir o código do veltra-examples, um conjunto de projetos pequenos, completos e prontos para copiar e colar que mostram como construir ferramentas reais sobre a API de histórico de trades de carteiras da Veltra. Cada um é clonado, roda com npm install && npm start e foi feito para ser levado direto para o seu projeto.

A ideia é simples: a API entrega o histórico completo e já processado de compras e vendas de uma carteira a partir de um único endpoint, então, em vez de documentação, você pode ler um programa funcionando que já faz aquilo que você quer.

O que tem dentro

• pnl-tracker: lucro e prejuízo realizados por token com custo de aquisição FIFO, taxa de acerto e posições abertas. Contabilidade de verdade, não uma estimativa de SOL que entra e SOL que sai.
• copy-trade-backtester: "se eu tivesse copiado esta carteira, quanto teria ganhado?". Reproduz o histórico de uma carteira com banca finita, tamanho de posição fixo e slippage em cada execução.
• trade-scoring: um pipeline de machine learning que extrai características do histórico de uma carteira e treina um modelo para pontuar o quão habilidosa ela é, com um modo para rotular as suas próprias carteiras.
• wallet-watcher: consulta uma carteira e avisa no momento em que ela faz um novo trade, no seu terminal ou encaminhado para um webhook do Discord ou do Slack.

Um endpoint, muitas ferramentas

Todos os exemplos são construídos sobre uma única chamada: GET /v1/wallets/{address}/history. Ela devolve cada trade como uma linha limpa, com lado, token, mint, valor em SOL, quantidade de token, DEX e timestamp, sem decodificação de transações do seu lado. Esse único fluxo de "quem comprou e vendeu o quê, por quanto, onde e quando" basta para calcular custo de aquisição, testar uma estratégia de cópia, treinar um modelo de pontuação ou monitorar novas atividades.

Não usa JavaScript? O repositório também traz um livro de receitas de curl, com streaming, paginação, multichain, tratamento de erros e one-liners com jq, que se traduz sem atrito para qualquer linguagem.

Comece com uma única chamada

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

Feito para ser copiado

• Cada exemplo é uma pasta independente: copie o que você precisa e ignore o resto. Não há ferramentas de monorepo para aprender.
• Cada exemplo faz trabalho real sobre os dados em vez de apenas reimprimir a resposta da API.
• Os exemplos de estilo trading são simulações históricas honestas, não execução ao vivo, e dizem com clareza o que modelam e o que não modelam.
• Cada um traz os próprios testes, e o CI roda verificação de tipos e testes para todos eles.

Pegue o código

O código-fonte completo está no GitHub, em https://github.com/QuirkyTurtle11/veltra-examples, com licença MIT. Pegue uma API key: o teste gratuito é suficiente para rodar todos os exemplos.