Defi Agents

🤖 DeFi Agents API - AI Agent Definitions for Web3

> 42 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.

---

✨ Key Features

• ✅ 42 Production-Ready Agents - DeFi, portfolio, trading, Web3, education
• ✅ 18 Languages - Automated i18n translation workflow ([Learn More →](./docs/I18N_WORKFLOW.md))
• ✅ RESTful JSON API - Easy integration for developers and LLMs ([API Docs →](./docs/API.md))
• ✅ Machine-Readable Indexes - Agent manifest for AI crawlers ([agents-manifest.json](./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

---

🚀 Quick Start

For AI Systems & LLMs

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.json

[Complete API Documentation →](./docs/API.md)

For Users

Add agents to your AI platform:

https://sperax.click/index.json

Or with language:

https://sperax.click/index.{locale}.json

For Developers

git clone https://github.com/nirholas/defi-agents.git
cd defi-agents
bun install
bun run format
bun run build

[Complete Development Workflow Guide →](./docs/WORKFLOW.md)

---

📦 Agent Categories

🌟 Featured Agent

🎯 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

⚠️ Current Status: Read-only portfolio tracking and analytics available now. Automated trading, bots, and DeFi interactions coming soon in SperaxOS roadmap.

View Agent → | Try Now →

---

🪙 DeFi & Crypto (42 Specialized Agents)

Sperax Ecosystem (8 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.fun for testing. The domain may change to sperax.io or similar once SperaxOS launches in production. [See FAQ](./docs/FAQ.md#sperax-portfolio-agents) for details.

General DeFi (34 Agents) + Crypto News:

• 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

View Full Agent List →

---

🤝 Agent Teams

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.

[Read Teams Guide →](./docs/TEAMS.md)

---

🌍 Multi-Language Support

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

---

🛠️ API Reference

Endpoints

# 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

Quick Integration

// 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();

[Full API Documentation →](./docs/API.md)

---

🤖 Contributing an Agent

We welcome contributions! Submit your agent to expand the library.

Quick Submit

1. Fork this repository
2. 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
}

1. Submit a Pull Request

Our automated workflow will translate your agent to 18 languages and deploy it globally.

Quality Guidelines

✅ Clear purpose - solves a specific problem\ ✅ Well-structured prompts - comprehensive but focused\ ✅ Appropriate tags - aids discovery\ ✅ Tested - verified functionality

[Full Contributing Guide →](./docs/CONTRIBUTING.md)

---

📖 Documentation

For Users

• [Agent Teams Guide](./docs/TEAMS.md) - Multi-agent collaboration
• [FAQ](./docs/FAQ.md) - Common questions
• [Examples](./docs/EXAMPLES.md) - Real-world use cases

For Developers

• [Complete Workflow Guide](./docs/WORKFLOW.md) - End-to-end development process
• [Contributing Guide](./docs/CONTRIBUTING.md) - How to submit agents
• [API Reference](./docs/API.md) - Complete API documentation
• [Agent Creation Guide](./docs/AGENT_GUIDE.md) - Design effective agents
• [18 Languages i18n Workflow](./docs/I18N_WORKFLOW.md) - Automated translation system
• [Deployment Guide](./docs/DEPLOYMENT.md) - Domain setup and CI/CD
• [Prompt Engineering](./docs/PROMPTS.md) - Writing better prompts
• [Model Parameters](./docs/MODELS.md) - Temperature, top_p explained
• [Troubleshooting](./docs/TROUBLESHOOTING.md) - Common issues

---

🚀 Deployment

GitHub Pages (Automatic)

1. Fork/Clone this repository
2. Choose your domain option:

• Default GitHub Pages: Delete the CNAME file
• Custom Domain: Update CNAME with your domain

1. Enable GitHub Pages:

• Settings → Pages → Source: gh-pages branch

1. 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

Custom Domain Setup

1. Update CNAME file: echo "yourdomain.com" > CNAME
2. Configure DNS: Add CNAME record → [username].github.io
3. 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.

[Full Deployment Guide →](./docs/DEPLOYMENT.md)

---

🔧 Development Tools

Split Agent Batches

node split-agents.cjs

Converts batch JSON into individual agent files.

Emoji Converter

node emoji-converter.cjs

Converts emoji URLs to native Unicode.

---

🌐 Integration Examples

Custom Application

// 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;

Python

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']]

---

🔐 Security & Privacy

• 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

---

📊 Stats

• 42 Agents - DeFi-focused coverage
• 18 Languages - Global accessibility via automated translation
• 8 Sperax Specialists - Ecosystem-specific agents (7 core + 1 portfolio master)
• 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

---

🔗 Projects Building with AI Agents Library 🤍

• SperaxOS - Application Branch

---

📜 License

MIT License - see [LICENSE](LICENSE) file for details.

Open Source • Open Format • Open Future

---

Sperax Portfolio

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

---

Crypto Whale Watcher

By @sperax on 2024-12-16

Track and analyze large wallet movements and whale behavior

on-chain whale analytics trading monitoring

---

Cross-Chain Bridge Security Analyst

By @sperax on 2024-12-16

Evaluate bridge security and recommend safest cross-chain routes

bridge security cross-chain risk multichain

---

Token Unlock Schedule Tracker

By @sperax on 2024-12-16

Monitor and analyze token unlock events and their market impact

tokenomics unlocks vesting supply analysis

---

veSPA Lock Optimizer

By @sperax on 2024-12-16

Maximize returns through optimal veSPA locking strategies

sperax vespa staking optimization voting-power

---

Sperax Portfolio Tracker

By @sperax on 2024-12-16

Track and analyze your complete Sperax ecosystem holdings

sperax portfolio tracking analytics dashboard

---

DeFi Insurance & Risk Coverage Advisor

By @sperax on 2024-12-16

Navigate DeFi insurance options for smart contract protection

insurance protection risk coverage safety

---

NFT Liquidity & Lending Advisor

By @sperax on 2024-12-16

Navigate NFT-backed lending and liquidity solutions

nft liquidity lending collateral defi

---

USDs Stablecoin Expert

By @sperax on 2024-12-16

Specialist in Sperax USDs mechanism, collateralization, and yield strategies

sperax stablecoin usds defi yield

---

DEX Aggregator Route Optimizer

By @sperax on 2024-12-16

Find optimal swap routes across DEX aggregators

dex swap routing aggregator optimization

---

Crypto Tax Strategy Advisor

By @sperax on 2024-12-16

Optimize crypto taxes and provide tax-efficient DeFi strategies

tax strategy accounting optimization compliance

---

Smart Contract Security Auditor

By @sperax on 2024-12-16

Review and assess smart contract security for DeFi protocols

security smart-contracts audit solidity risk

---

Sperax Yield Aggregator

By @sperax on 2024-12-16

Find and optimize best yield opportunities in Sperax ecosystem

sperax yield farming optimization apy

---

Personal DeFi Dashboard Builder

By @sperax on 2024-12-16

Design and track your custom DeFi portfolio dashboard

dashboard tracking portfolio analytics monitoring

---

Crypto Wallet Security Advisor

By @sperax on 2024-12-16

Best practices for securing crypto wallets and assets

security wallet safety best-practices hardware

---

DeFi Yield Sustainability Analyst

By @sperax on 2024-12-16

Analyze whether high yields are sustainable or temporary

defi yield sustainability analysis tokenomics

---

Stablecoin Deep Comparator

By @sperax on 2024-12-16

Compare stablecoin mechanisms, risks, and use cases

stablecoin usdc dai usdt comparison

---

DeFi Portfolio Rebalancing Advisor

By **[@sperax](https://github.com/nirholas/AI-Agents-L

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nirholas
• Source: nirholas/defi-agents
• License: MIT
• Homepage: https://defiagents.vercel.app

Install and usage instructions live in the source repository linked above.