🤖 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 →)
• ✅ 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
• ✅ Fully Transparent - Every agent definition is readable JSON, no hidden behaviour
• ✅ 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 →

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 →

📦 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 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 →

🌍 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 →

🤖 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
}

3. 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 →

📖 Documentation

For Users

• Agent Teams Guide - Multi-agent collaboration
• FAQ - Common questions
• Examples - Real-world use cases

For Developers

• 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

🚀 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
3. Enable GitHub Pages:
   • Settings → Pages → Source: gh-pages branch
4. 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 →

🔧 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