AgentX-Examples

A curated collection of production-ready example agents built with the AgentX Protocol. Use these as starting points for your own autonomous agents.

---

Examples

Example	Description	Difficulty
trading_agent/	Autonomous DeFi trading agent with on-chain execution	⭐⭐⭐
social_agent/	Social media monitoring and auto-response agent	⭐⭐
research_agent/	Web research and report generation agent	⭐
notebooks/agent_tutorial.ipynb	Step-by-step Jupyter tutorial for building your first agent	⭐

---

Installation

git clone https://github.com/agentx-protocol/AgentX-Examples.git
cd AgentX-Examples
pip install -r requirements.txt

Copy .env.example to .env and add your API keys:

cp .env.example .env
# Edit .env with your OPENAI_API_KEY etc.

---

Running the Examples

Trading Agent

python examples/trading_agent/main.py

Simulates a trading agent that:

1. Fetches mock price data for SOL, ETH, BTC
2. Runs technical analysis (RSI, MACD-style signals)
3. Proposes and logs a trade decision
4. (Optional) Executes on devnet via AgentX Solana program

Social Agent

python examples/social_agent/bot.py

Monitors a mock tweet stream and:

1. Classifies incoming posts (sentiment, topic)
2. Drafts AI-generated replies for relevant tweets
3. Posts replies (dry-run by default, set DRY_RUN=false to live-post)

Jupyter Tutorial

jupyter notebook notebooks/agent_tutorial.ipynb

---

Structure

AgentX-Examples/
├── examples/
│   ├── trading_agent/
│   │   ├── main.py          # Entry point
│   │   ├── strategy.py      # Trading strategy logic
│   │   └── market_data.py   # Mock market data API
│   └── social_agent/
│       ├── bot.py           # Entry point
│       ├── classifier.py    # Tweet classifier
│       └── replier.py       # Reply generator
├── notebooks/
│   └── agent_tutorial.ipynb
├── requirements.txt
└── .env.example

---

Contributing

Have a cool agent to share? Open a PR! Please:

• Include a clear README for your example
• Use mock data (no real API keys hardcoded)
• Add basic error handling

---

License

MIT — see LICENSE.