58 production-ready AI agent definitions for DeFi, portfolio management, trading, and Web3 workflows. RESTful JSON API with 18-language support.
A comprehensive, discoverable API hosting specialized AI agent schemas with universal compatibility. Works with any AI platform, LLM, or chatbot that supports agent indexes - no vendor lock-in, no platform restrictions. Perfect for developers, LLMs, and AI systems building Web3 applications.
- ✅ 58 Production-Ready Agents - DeFi, portfolio, trading, Web3, education
- ✅ 18 Languages - Automated i18n translation workflow (Learn More →)
- ✅ RESTful JSON API - Easy integration for developers and LLMs (API Docs →)
- ✅ Machine-Readable Indexes - Agent manifest for AI crawlers (agents-manifest.json)
- ✅ Universal Format - Standard JSON schema works with any platform
- ✅ No Vendor Lock-in - Switch platforms without losing work
- ✅ Open Source - MIT licensed, fully transparent
- ✅ SEO & AI Friendly - robots.txt, structured data, semantic indexing
- ✅ CDN Hosted - GitHub Pages for fast global access
- ✅ Custom Domain Ready - Easy white-labeling
Discover agents via the API:
# Get all agents (English)
curl https://sperax.click/index.json
# Get agents in any language
curl https://sperax.click/index.zh-CN.json
# Get agent manifest for indexing
curl https://sperax.click/agents-manifest.jsonAdd agents to your AI platform:
https://sperax.click/index.json
Or with language:
https://sperax.click/index.{locale}.json
git clone https://github.com/nirholas/defi-agents.git
cd defi-agents
bun install
bun run format
bun run buildComplete Development Workflow Guide →
🎯 Sperax Portfolio - All-in-one crypto portfolio management ⭐ RECOMMENDED
- Complete portfolio tracking, trading automation, DeFi protocols, and analytics
- ONE agent for 100% of portfolio management features
- Perfect for most users - install once, access everything
Sperax Ecosystem (24 Agents):
Master Agent (Recommended):
- Sperax Portfolio 🎯 - All-in-one portfolio management (dashboard, trading, bots, DeFi, analytics)
Original Sperax Agents (7):
- USDs Stablecoin Expert, SPA Tokenomics Analyst, veSPA Lock Optimizer
- Governance Guide, Liquidity Strategist, Bridge Assistant, Yield Aggregator
SperaxOS Portfolio Specialists (16): 💡 For advanced users who prefer focused tools
- Portfolio Dashboard, Assets Tracker, Analytics Expert, Wallet Manager
- Trading Assistant, AI Trading Bot, Signal Bot, DCA Bot
- Arbitrage Bot, Pump Screener, DeFi Center, DeFi Protocols
- Strategies Marketplace, Bot Templates, Settings Manager, Help Center
Note: SperaxOS portfolio agents currently use
sperax.funfor testing. The domain may change tosperax.ioor similar once SperaxOS launches in production. See FAQ for details.
General DeFi (34 Agents):
- Yield Farming Optimizer, Impermanent Loss Calculator, Gas Optimizer
- Smart Contract Auditor, MEV Protection Advisor, Whale Watcher
- Protocol Comparator, Token Unlock Tracker, Liquidation Risk Manager
- Airdrop Hunter, Alpha Leak Detector, APY vs APR Educator
- Bridge Security Analyst, Crypto Tax Strategist, DeFi Insurance Advisor
- DeFi Onboarding Mentor, DeFi Protocol Comparator, DeFi Risk Scoring Engine
- DEX Aggregator Optimizer, Governance Proposal Analyst, Layer 2 Comparison Guide
- Liquidation Risk Manager, Liquidity Pool Analyzer, Narrative Trend Analyst
- NFT Liquidity Advisor, Portfolio Rebalancing Advisor, Protocol Revenue Analyst
- Protocol Treasury Analyst, Stablecoin Comparator, Staking Rewards Calculator
- Wallet Security Advisor, Yield Dashboard Builder, Yield Sustainability Analyst
Create collaborative teams of specialized agents that work together on complex tasks.
Example Team - DeFi Strategy:
- Yield Optimizer (finds opportunities)
- Risk Assessment Agent (evaluates safety)
- Portfolio Tracker (monitors performance)
- Gas Optimizer (minimizes costs)
The host agent coordinates discussion, ensuring each specialist contributes their expertise while building toward a comprehensive solution.
All agents automatically available in 18 languages:
🇺🇸 English・🇨🇳 简体中文・🇹🇼 繁體中文・🇯🇵 日本語・🇰🇷 한국어・🇩🇪 Deutsch・🇫🇷 Français・🇪🇸 Español・🇷🇺 Русский・🇸🇦 العربية・🇵🇹 Português・🇮🇹 Italiano・🇳🇱 Nederlands・🇵🇱 Polski・🇻🇳 Tiếng Việt・🇹🇷 Türkçe・🇸🇪 Svenska・🇮🇩 Bahasa Indonesia
# Main index (all agents)
GET https://nirholas.github.io/AI-Agents-Library/index.json
# Individual agent (English)
GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.json
# Localized agent
GET https://nirholas.github.io/AI-Agents-Library/{agent-id}.zh-CN.json
# Language-specific index
GET https://nirholas.github.io/AI-Agents-Library/index.zh-CN.json// Load all agents
const response = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json');
const { agents } = await response.json();
// Load specific agent
const agent = await fetch(`https://nirholas.github.io/AI-Agents-Library/defi-yield-optimizer.json`);
const agentConfig = await agent.json();We welcome contributions! Submit your agent to expand the library.
- Fork this repository
- Create your agent in
src/your-agent-name.json
{
"author": "your-github-username",
"config": {
"systemRole": "You are a [role] with expertise in [domain]..."
},
"identifier": "your-agent-name",
"meta": {
"title": "Agent Title",
"description": "Clear, concise description",
"avatar": "🤖",
"tags": ["category", "functionality", "domain"]
},
"schemaVersion": 1
}- Submit a Pull Request
Our automated workflow will translate your agent to 18 languages and deploy it globally.
✅ Clear purpose - solves a specific problem
✅ Well-structured prompts - comprehensive but focused
✅ Appropriate tags - aids discovery
✅ Tested - verified functionality
- Agent Teams Guide - Multi-agent collaboration
- FAQ - Common questions
- Examples - Real-world use cases
- Complete Workflow Guide - End-to-end development process
- Contributing Guide - How to submit agents
- API Reference - Complete API documentation
- Agent Creation Guide - Design effective agents
- 18 Languages i18n Workflow - Automated translation system
- Deployment Guide - Domain setup and CI/CD
- Prompt Engineering - Writing better prompts
- Model Parameters - Temperature, top_p explained
- Troubleshooting - Common issues
- Fork/Clone this repository
- Choose your domain option:
- Default GitHub Pages: Delete the
CNAMEfile - Custom Domain: Update
CNAMEwith your domain
- Default GitHub Pages: Delete the
- Enable GitHub Pages:
- Settings → Pages → Source:
gh-pagesbranch
- Settings → Pages → Source:
- Push to main - GitHub Actions automatically builds and deploys
Your agents will be at:
- Default:
https://[username].github.io/[repository]/index.json - Custom:
https://yourdomain.com/index.json
- Update CNAME file:
echo "yourdomain.com" > CNAME - Configure DNS: Add CNAME record →
[username].github.io - Enable HTTPS in repository settings after DNS propagates
Note: The build process automatically copies your CNAME to the deployment, so your custom domain persists across all deployments. Forks can simply update or delete the CNAME file.
node split-agents.cjsConverts batch JSON into individual agent files.
node emoji-converter.cjsConverts emoji URLs to native Unicode.
// Fetch agents
const agents = await fetch('https://nirholas.github.io/AI-Agents-Library/index.json').then((r) =>
r.json(),
);
// Use with your AI model
const systemPrompt = agents.agents[0].config.systemRole;import requests
# Load agents
response = requests.get('https://nirholas.github.io/AI-Agents-Library/index.json')
agents = response.json()['agents']
# Filter by tag
defi_agents = [a for a in agents if 'defi' in a['meta']['tags']]- No data collection - Static JSON index, zero tracking
- Agents run locally - Execute in your AI platform's environment
- Open source - Full transparency, audit every line
- No external calls - Pure JSON configuration files
- 58 Agents - DeFi-focused coverage
- 18 Languages - Global accessibility via automated translation
- 23 Sperax Specialists - Ecosystem-specific agents (7 core + 16 portfolio plugins)
- 34 General DeFi Agents - Comprehensive DeFi toolkit
- ~300 KB Index - Fast loading (gzipped: ~65 KB)
- 80-120ms - Global CDN delivery
- 0 Vendor Lock-in - True interoperability
- SperaxOS - Application Branch
MIT License - see LICENSE file for details.
Open Source • Open Format • Open Future
By @sperax on 2024-12-21
DeFi protocol explorer with TVL tracking and APY comparison
defi protocols tvl research sperax
By @sperax on 2024-12-21
Deep portfolio analytics with performance charts and profit/loss analysis
analytics performance charts insights sperax
By @sperax on 2024-12-21
Trading signals based on technical analysis and market indicators
signals technical-analysis indicators alerts sperax
By @sperax on 2024-12-21
Pre-built bot configurations for quick deployment
templates bots configuration automation sperax
By @sperax on 2024-12-21
High-momentum token screener for detecting pumping tokens
screener momentum pump volume sperax
By @sperax on 2024-12-21
Cross-exchange arbitrage detection and automated execution
arbitrage cross-exchange profit opportunity sperax
By @sperax on 2024-12-21
Help center with FAQs, tutorials, and support system
help support faq documentation sperax
By @sperax on 2024-12-21
Execute cryptocurrency trades with real-time market data and order management
trading execution orders swap sperax
By @sperax on 2024-12-21
Dollar-cost averaging automation for recurring crypto purchases
dca recurring automation accumulation sperax
By @sperax on 2024-12-21
AI-powered trading strategies with ML, backtesting, and automation
ai bot ml strategy automation sperax
By @sperax on 2024-12-21
Portfolio overview dashboard with total value, allocation, and performance metrics
portfolio dashboard overview sperax
By @sperax on 2024-12-21
DeFi protocol aggregator for managing positions and yields
defi yield liquidity protocols sperax
By @sperax on 2024-12-21
Application settings and preferences manager
settings configuration preferences api-keys sperax
By @sperax on 2024-12-21
Manage multiple crypto wallets with balance tracking and synchronization
wallets addresses management sync sperax
By @sperax on 2024-12-21
Trading strategy marketplace to browse and deploy proven strategies
strategies marketplace trading templates sperax
By @sperax on 2024-12-21
Track and analyze cryptocurrency holdings with detailed asset breakdowns
assets holdings crypto tracking sperax
By @sperax on 2024-12-21
All-in-one cryptocurrency portfolio management: tracking, trading, automation, DeFi, and analytics
portfolio trading defi analytics automation wallet bots sperax all-in-one master
By @sperax on 2024-12-16
Track and analyze large wallet movements and whale behavior
on-chain whale analytics trading monitoring
By @sperax on 2024-12-16
Evaluate bridge security and recommend safest cross-chain routes
bridge security cross-chain risk multichain
By @sperax on 2024-12-16
Monitor and analyze token unlock events and their market impact
tokenomics unlocks vesting supply analysis
By @sperax on 2024-12-16
Maximize returns through optimal veSPA locking strategies
sperax vespa staking optimization voting-power
By @sperax on 2024-12-16
Track and analyze your complete Sperax ecosystem holdings
sperax portfolio tracking analytics dashboard
By @sperax on 2024-12-16
Navigate DeFi insurance options for smart contract protection
insurance protection risk coverage safety
By @sperax on 2024-12-16
Navigate NFT-backed lending and liquidity solutions
nft liquidity lending collateral defi
By @sperax on 2024-12-16
Specialist in Sperax USDs mechanism, collateralization, and yield strategies
sperax stablecoin usds defi yield
By @sperax on 2024-12-16
Find optimal swap routes across DEX aggregators
dex swap routing aggregator optimization
By @sperax on 2024-12-16
Optimize crypto taxes and provide tax-efficient DeFi strategies
tax strategy accounting optimization compliance
By @sperax on 2024-12-16
Review and assess smart contract security for DeFi protocols
security smart-contracts audit solidity risk
By @sperax on 2024-12-16
Find and optimize best yield opportunities in Sperax ecosystem
sperax yield farming optimization apy
By @sperax on 2024-12-16
Design and track your custom DeFi portfolio dashboard
dashboard tracking portfolio analytics monitoring
By @sperax on 2024-12-16
Best practices for securing crypto wallets and assets
security wallet safety best-practices hardware
By @sperax on 2024-12-16
Analyze whether high yields are sustainable or temporary
defi yield sustainability analysis tokenomics
By @sperax on 2024-12-16
Compare stablecoin mechanisms, risks, and use cases
stablecoin usdc dai usdt comparison
By @sperax on 2024-12-16
Optimize portfolio allocation and rebalancing strategies
portfolio rebalancing allocation strategy optimization
By @sperax on 2024-12-16
Help newcomers understand and start using Sperax protocol
sperax education onboarding beginner tutorial
By @sperax on 2024-12-16
Identify and optimize yield farming opportunities across DeFi protocols
defi yield-farming apy strategy optimization
By @sperax on 2024-12-16
Navigate Sperax DAO proposals, voting, and protocol upgrades
sperax governance dao voting proposals
By @sperax on 2024-12-16
Compare similar DeFi protocols across features, risks, and yields
defi comparison protocols analysis research
By @sperax on 2024-12-16
Guide complete beginners through their first DeFi experiences
education beginner onboarding tutorial defi-basics
By @sperax on 2024-12-16
Explain and calculate the difference between APY and APR in DeFi
defi education apy apr yields
By @sperax on 2024-12-16
Analyze DeFi protocol business models and revenue generation
defi revenue analysis fundamentals tokenomics
By @sperax on 2024-12-16
Analyze and explain DAO governance proposals and their implications
governance dao voting proposals analysis
By @sperax on 2024-12-16
Calculate and explain impermanent loss scenarios for LP positions
defi liquidity impermanent-loss calculator amm
By @sperax on 2024-12-16
Analyze DAO treasury holdings, runway, and capital allocation
treasury dao capital runway allocation
By @sperax on 2024-12-16
Monitor and manage liquidation risks in lending protocols
lending liquidation risk collateral defi
By @sperax on 2024-12-16
Track and analyze dominant narratives and trends in crypto markets
narrative trends analysis sentiment market-cycles
By @sperax on 2024-12-16
Track and analyze security risks across Sperax smart contracts
sperax security risk audit monitoring
By @sperax on 2024-12-16
Analyze LP pool health, risks, and optimal entry/exit timing
defi liquidity-pools amm analysis risk
By @sperax on 2024-12-16
Expert in SPA token economics, staking rewards, and protocol revenue
sperax spa tokenomics staking governance
By @sperax on 2024-12-16
Minimize gas costs and optimize transaction timing
ethereum gas optimization layer-2 efficiency
By @sperax on 2024-12-16
Identify trading alpha and early signals in DeFi markets
alpha trading signals research opportunities
By @sperax on 2024-12-16
Protect users from front-running, sandwich attacks, and MEV exploitation
mev security front-running flashbots protection
By @sperax on 2024-12-16
Optimize liquidity provision strategies across Sperax pools
sperax liquidity amm yield-farming impermanent-loss
By @sperax on 2024-12-16
Guide users through cross-chain bridging with optimal routes and costs
sperax bridge cross-chain arbitrum layer-2
By @sperax on 2024-12-16
Calculate and optimize staking rewards across protocols
staking rewards calculator pos yields
By @sperax on 2024-12-16
Comprehensive risk assessment framework for DeFi protocols
risk assessment scoring analysis framework
By @sperax on 2024-12-16
Identify and strategize for potential protocol airdrops
airdrop rewards strategy farming allocation
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
