VEX DOCUMENTATION
Welcome to the VEX documentation. VEX is an AI-powered agent for the Solana ecosystem that enables you to trade, launch tokens, and manage your portfolio using natural language commands.
Quick Start Guide
Open VEX App
Navigate to VEX App to start chatting with the AI agent.
Enter Your Command
Use natural language to give instructions. For example: "what's trending?" or "check if this token is a rug".
Get Results
VEX will process your request and provide the information or action you need.
Powered by Qwen2.5-72B
VEX utilizes the Qwen2.5-72B AI model via OpenRouter. This model was selected for its exceptional ability to understand complex instructions, perform multi-step reasoning, and generate accurate outputs for blockchain operations.
SYSTEM ARCHITECTURE
VEX is built with a modern architecture that separates the frontend, backend, and AI agent into distinct components. Below are the main system components:
Frontend (SvelteKit)
A web application built with SvelteKit and TailwindCSS. Handles the chat UI, wallet connections, and displays results from the agent.
- • SvelteKit for SSR and routing
- • TailwindCSS for styling
- • Solana Wallet Adapter for wallet connections
- • SSE (Server-Sent Events) for streaming
Backend (Hono)
An API server built with the Hono framework. Handles requests from the frontend and orchestrates the AI agent.
- • Hono for routing and middleware
- • Node.js runtime
- • SSE streaming for real-time responses
- • Integration with various external APIs
AI Agent (ReAct Pattern)
An agent that uses the ReAct (Reason + Act) pattern to process user instructions and execute appropriate tools.
- • Qwen2.5-72B via OpenRouter
- • Tool calling for execution
- • Memory for conversation context
- • Streaming responses
External APIs
VEX integrates with various APIs to access data and execute transactions on Solana.
- • Jupiter for swaps
- • Helius for wallet data
- • Birdeye for prices and trending
- • Pump.fun for token launches
The ReAct Pattern: How the Agent Works
REASON
The agent receives your input and analyzes what needs to be done. It determines which tools are required and in what order they should be executed.
ACT
The agent executes the selected tool — for example, fetching token prices, preparing a swap, or checking token security.
OBSERVE
The agent observes the results from the tool, then decides whether to run another tool or if it has sufficient information to respond to your request.
COMMANDS & EXAMPLES
VEX understands natural language, so you don't need to use rigid syntax. Below are examples of commands you can use:
⟲ Trading Commands
swap [amount] [from] for [to] Jupiter AggregatorExecute a token swap using Jupiter with optimal routing. Supports all SPL tokens available on Jupiter.
buy [amount] of [token] Jupiter AggregatorPurchase tokens using SOL or stablecoins. VEX will automatically calculate the required amounts.
◎ Portfolio Commands
show my portfolio Helius DASDisplay all tokens you own along with their USD values.
check my PnL Helius + BirdeyeCalculate your profit and loss from trading over a specified time period.
⬡ Research Commands
check if [token] is a rug RugCheck.xyzAnalyze a token for potential rug pull indicators: ownership concentration, liquidity, mint authority, and more.
info [token] BirdeyeGet detailed information about a token: price, market cap, volume, holders, and more.
trending tokens BirdeyeDisplay trending tokens based on volume and price momentum.
◆ Launch Commands
launch token [name] Pump.funDeploy a new token on Pump.fun with an automatic bonding curve.
TOOLS & APIS
VEX integrates with the best APIs and protocols in the Solana ecosystem to provide a comprehensive trading experience.
Jupiter Aggregator v6
Trading & SwapsJupiter is the largest DEX aggregator on Solana. VEX uses Jupiter to get the best prices with automatic routing across multiple DEXs like Raydium, Orca, Meteora, and more.
Helius DAS API
Wallet Data & NFTsHelius provides the Digital Asset Standard (DAS) API for retrieving wallet data, token balances, NFTs, and transactions with high performance.
Birdeye API
Market Data & AnalyticsBirdeye is an analytics platform for Solana DeFi. VEX uses Birdeye for real-time price data, trending tokens, and market analysis.
Pump.fun API
Token LaunchPump.fun is a platform for launching memecoins with bonding curves. VEX allows you to create new tokens directly from the chat interface.
RugCheck.xyz
Security AnalysisRugCheck analyzes tokens to detect potential rug pulls. VEX automatically checks token security before you trade.
SECURITY
Security is VEX's top priority. Below are the security principles we implement and tips for keeping your assets safe.
VEX Security Principles
No Private Key Access
VEX never sees or stores your private keys. All transactions are signed within your wallet.
Explicit Approval Required
Every transaction requires a signature from your wallet. VEX cannot execute without your approval.
Full Transparency
You can see complete transaction details before approving, including fee estimates and risks.
Automatic Rug Checks
VEX automatically checks token security before trading to protect you from rug pulls.
Security Tips
Never Share Your Seed Phrase
Your seed phrase is the key to your wallet. Anyone who has it can access all your assets. VEX will never ask for it.
Verify Before Signing
Always carefully review transaction details before signing. Ensure amounts and destination addresses are correct.
Use a Hardware Wallet
For large amounts of assets, consider using a hardware wallet like Ledger for additional security.
Beware of Phishing
Make sure you're accessing VEX from the correct URL. Bookmark the official site and don't click links from untrusted sources.
FREQUENTLY ASKED QUESTIONS
Common questions about VEX answered.
Is VEX free to use?
Yes, VEX is free to use during the early access period. You only pay standard Solana network fees and DEX fees (such as Jupiter's 0.5% swap fee). There are no additional charges from VEX.
What AI model does VEX use?
VEX uses Qwen2.5-72B via OpenRouter. This model was chosen for its exceptional reasoning capabilities, ability to understand complex contexts, and accuracy in generating outputs for trading operations.
Can VEX trade without my approval?
No. Every transaction involving your assets requires a signature from your wallet. VEX can only plan and prepare transactions; execution always requires your explicit approval.
What happens if a transaction fails?
If a transaction fails, VEX will display an error message and suggest solutions. No funds are lost on failed transactions — you only pay a very small gas fee (usually less than $0.01).
Is there a mobile app?
There's no dedicated mobile app yet, but VEX works well in mobile browsers. Make sure your wallet is installed on your mobile device for a smooth connection.
How do I report bugs or provide feedback?
You can reach us via X (Twitter) at @vex_agent. We greatly appreciate feedback to continuously improve VEX.
READY TO GET STARTED?
Start trading with natural language now.