veltra-cli

Command-line tool for the Veltra wallet trade-history API. Fetch, stream, and inspect any wallet's trade history straight from your terminal.

veltra history Bi4rd5FH5bYEN8scZ7wevxNZyNmKHdaBcvewdPFxYdLt --limit 5

Install

npm install -g veltra-cli

Or run it without installing:

npx veltra-cli history <wallet> --limit 5

Requires Node.js 18+.

Setup

The CLI reads your API key from VELTRA_API_KEY (or --api-key):

export VELTRA_API_KEY="your-key"   # get one at https://veltrabot.com

Commands

veltra history <wallet>

Fetch a wallet's trade history.

veltra history <wallet>                 # full history
veltra history <wallet> --limit 100     # just the newest 100 trades
veltra history <wallet> --chain ethereum
veltra history <wallet> --json          # raw JSON for piping into jq

Options

Flag	Meaning
--chain <chain>	Chain to query (default solana; e.g. ethereum, base)
--limit <n>	Fetch just the newest n trades (a single page)
--json	Output raw JSON
--api-key <key>	API key (or set VELTRA_API_KEY)
-h, --help	Show help
-v, --version	Show version

Piping

--json makes the CLI composable with jq and friends:

veltra history <wallet> --limit 1000 --json \
  | jq '[.trades[] | select(.side=="buy") | .amountSol] | add'

More

• API documentation
• Pricing (100,000 trades free, no card)
• veltra-sdk for the same API from TypeScript
• veltra-mcp to give an AI assistant the same access

Contributing

git clone https://github.com/QuirkyTurtle11/veltra-cli
cd veltra-cli
npm install
npm run typecheck
npm test
npm run build
npm link          # makes your local `veltra` available on PATH

License

MIT