Autonomous Solana research & trading intelligence agent.
Think Claude Code, but built for Solana.
Soldexter is a terminal-native AI agent that takes natural language questions about Solana tokens, wallets, and markets — then autonomously researches them using live on-chain and off-chain data.
It decomposes complex questions into multi-step research plans, executes 6+ tools in parallel, cross-references results, and produces actionable trading intelligence. All from your terminal.
- 6 Solana-native tools — Token analysis, DEX data, wallet forensics, TX decode, trending tokens, holder analysis
- Parallel execution — Tools run concurrently with automatic cross-referencing
- Subagent spawning — Delegate sub-tasks to isolated parallel agents
- Persistent memory — Knowledge survives across sessions
- Paper-trade default — Jupiter swap quotes without execution, live requires explicit double opt-in
- Multiple LLM backends — OpenAI, Anthropic, Google, or local via Ollama
# Clone
git clone https://github.com/aegntic/soldexter.git
cd soldexter
# Install
bun install
# Set up API keys (at minimum Helius + Birdeye)
export HELIUS_API_KEY=your_helius_key
export BIRDEYE_API_KEY=your_birdeye_key
export OPENAI_API_KEY=your_openai_key # or use ollama for local
# Run
bun run dev| Tool | Description | Source |
|---|---|---|
get_token_info |
Token metadata, supply, freeze authority, age, creator, pump.fun detection | Helius DAS |
get_dex_data |
Live price, volume, liquidity, price changes, DEX pair data | Birdeye |
get_wallet_activity |
Wallet transaction history — parsed swaps, transfers, amounts, programs | Helius RPC |
decode_transaction |
Full forensic breakdown: programs, inner instructions, token transfers, fees | Helius |
get_trending_tokens |
Trending tokens by volume/momentum with liquidity filtering | Birdeye |
get_token_holders |
Top holders with supply concentration and wallet labels | Helius |
web_search |
Web search via Exa, Tavily, Perplexity, or LangSearch | Multi |
browser |
JavaScript-rendered page navigation and scraping | Playwright |
memory |
Persistent knowledge base across sessions | Local |
spawn_subagent |
Delegate focused sub-tasks to parallel agents | Internal |
> Analyze EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)
Soldexter: Fetching token info, DEX data, and top holders...
[parallel: get_token_info, get_dex_data, get_token_holders]
## USDC (USD Coin)
Price: $1.00 | MCap: $2.1B | Liquidity: $890M
Holders: 12.4M | Top 10: 45.2%
Age: 1,847 days | Freeze: None ✅ | Pump.fun: No ✅
Verdict: Stablecoin, deep liquidity, safe to transact.
> What is 7x4kX... doing right now?
Soldexter: Looking up wallet labels and recent activity...
[parallel: get_wallet_activity, search_wallet_labels, get_wallet_pnl]
## Wallet 7x4kX... Profile
Label: Known whale | 30d P&L: +$2.3M (+187%) | Win rate: 71%
Last action: Bought 85 SOL of POPE (3 min ago)
Pattern: Loading new meme launches — typical early-entry behavior.
> Show me trending tokens with >$50k liquidity
Soldexter: [get_trending_tokens with min_liquidity=50000]
## Trending (24h)
1. BONK2 — $0.0000034 (+187%, Vol: $4.2M, Liq: $890k)
2. MEW — $0.0023 (+94%, Vol: $2.1M, Liq: $340k)
3. POPE — $0.00000012 (+312%, Vol: $1.8M, Liq: $89k) ⚠️ Low liq
> Decode tx 5UjH...qKP2
Soldexter: [decode_transaction]
## Transaction Breakdown
Type: Swap | Program: Jupiter Aggregator v6
Token In: 50 SOL ($7,250) → Token Out: 42.3M BONK
Fee: 0.00005 SOL | Priority: 0.0001 SOL | CU: 204,800
Inner instructions: 4 (spl-token transfers, account updates)
Verdict: Standard Jupiter swap, no suspicious patterns.
| Provider | Capabilities |
|---|---|
| Helius | Solana RPC, DAS API, enhanced transactions, wallet labels, webhooks |
| Birdeye | Token prices, OHLCV candles, trending tokens, wallet P&L |
| Jupiter v6 | Swap quotes, route planning, paper-trade / live execution |
┌─────────────────────────────────────────────┐
│ Soldexter │
├──────────┬──────────┬───────────┬───────────┤
│ Agent │ Tools │ Providers │ Memory │
│ Core │ (6+) │ (3) │ (persist) │
├──────────┴──────────┴───────────┴───────────┤
│ Subagent Spawning Layer │
├──────────────────────────────────────────────┤
│ Helius RPC │ Birdeye API │ Jupiter v6 API │
└──────────────────────────────────────────────┘
Built on Dexter's proven agent loop:
- Plan → Execute → Validate → Refine — Iterative research with self-correction
- Parallel tool execution — Multiple data sources queried simultaneously
- Context window management — Handles long sessions without degradation
- JSONL scratchpad — Full audit log of every agent decision and tool call
Soldexter defaults to paper-trade mode. Swap quotes are fetched from Jupiter and displayed without executing any on-chain transaction.
To enable live trading (requires explicit double opt-in):
export EXECUTION_ENABLED=true # opt-in 1
export MAINNET_ENABLED=true # opt-in 2
export SOLANA_KEYPAIR=path/to/keypair.jsonBoth flags must be set. Paper mode is always the default.
| Variable | Required | Description |
|---|---|---|
HELIUS_API_KEY |
Yes | Helius RPC and DAS API access |
BIRDEYE_API_KEY |
Yes | Birdeye price and market data |
OPENAI_API_KEY |
One LLM | OpenAI GPT models |
ANTHROPIC_API_KEY |
or | Anthropic Claude models |
GOOGLE_API_KEY |
or | Google Gemini models |
EXECUTION_ENABLED |
No | Enable swap execution (opt-in 1) |
MAINNET_ENABLED |
No | Enable mainnet transactions (opt-in 2) |
SOLANA_KEYPAIR |
No | Path to Solana keypair for execution |
- Runtime: Bun
- Language: TypeScript
- Agent Framework: LangChain.js
- Terminal UI: Ink (React for CLI)
- Browser: Playwright
- Zod schemas for structured tool I/O
Contributions are welcome. Open an issue or PR.
- Fork the repo
- Create a feature branch (
git checkout -b feat/my-feature) - Commit your changes
- Open a pull request
- Soldexter: Mattae Cooper (@aegntix) / aegntic
- Dexter (original): Virat Singh (@virattt) / Dexter Labs
Built with ☉ by @aegntix · Powered by Helius, Birdeye, Jupiter