Veltra 거래 내역 API로 만드는 오픈소스 예제

방금 veltra-examples를 오픈소스로 공개했습니다. Veltra 지갑 거래 내역 API 위에 실제 도구를 만드는 방법을 보여주는, 작고 완결적이며 복사해 붙여넣을 수 있는 프로젝트 모음입니다. 각 예제는 클론한 뒤 npm install && npm start로 실행되며, 여러분의 프로젝트에 그대로 옮겨 쓰도록 만들어졌습니다.

발상은 단순합니다. API가 하나의 엔드포인트에서 지갑의 완전하고 이미 파싱된 매수/매도 내역을 건네주므로, 문서 대신 원하는 일을 이미 수행하고 있는 동작하는 프로그램을 읽으면 됩니다.

무엇이 들어 있나

• pnl-tracker: 토큰별 FIFO 취득원가 기반 실현 손익, 승률, 미청산 포지션. SOL 유입/유출 추정이 아니라 실제 회계입니다.
• copy-trade-backtester: "이 지갑을 복사했다면 얼마를 벌었을까?"에 답합니다. 한정된 자본, 고정 포지션 크기, 모든 체결의 슬리피지를 적용해 지갑 내역을 재생합니다.
• trade-scoring: 지갑 내역에서 특징을 추출해 실력을 점수화하는 모델을 학습시키는 머신러닝 파이프라인. 직접 지갑에 라벨을 붙이는 모드도 있습니다.
• wallet-watcher: 지갑을 폴링하다가 새 거래가 발생하는 즉시 알림을 보냅니다. 터미널에 출력하거나 Discord, Slack webhook으로 전달합니다.

하나의 엔드포인트, 여러 도구

모든 예제는 단 한 번의 호출 위에 만들어졌습니다: GET /v1/wallets/{address}/history. 각 거래를 방향, 토큰, mint, SOL 가치, 토큰 수량, DEX, 타임스탬프가 담긴 깔끔한 행으로 반환하며 여러분 쪽에서 트랜잭션을 디코딩할 필요가 없습니다. "누가 무엇을 얼마에 어디서 언제 사고팔았는가"라는 이 하나의 흐름만으로 취득원가 계산, 복사 전략 백테스트, 스코어링 모델 학습, 신규 활동 감시가 모두 가능합니다.

JavaScript를 쓰지 않으신다면, 저장소에는 스트리밍, 페이지네이션, 멀티체인, 오류 처리, jq 한 줄 명령을 다루는 curl 쿡북도 함께 있습니다. 어떤 언어로도 매끄럽게 옮길 수 있습니다.

한 번의 호출로 시작하기

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

복사되기 위해 만들어졌습니다

• 각 예제는 독립된 폴더입니다. 필요한 것만 복사하고 나머지는 무시하세요. 배워야 할 monorepo 도구가 없습니다.
• 각 예제는 API 응답을 그대로 다시 출력하는 대신 데이터 위에서 실제 작업을 수행합니다.
• 트레이딩 계열 예제는 실시간 체결이 아니라 정직한 과거 시뮬레이션이며, 무엇을 모델링하고 무엇을 하지 않는지 분명히 밝힙니다.
• 각 예제는 자체 테스트를 포함하며 CI가 전부에 대해 타입 검사와 테스트를 실행합니다.

코드 받기

전체 소스는 GitHub의 https://github.com/QuirkyTurtle11/veltra-examples 에 MIT 라이선스로 공개되어 있습니다. API 키를 발급받으면 무료 체험만으로 모든 예제를 실행할 수 있습니다.