io.github.nirholas/defi-agents

Official

by nirholas · TypeScript

DeFi Trading Agents

DeFi agent definitions JSON API - crypto trading portfolio management bots

Provides DeFi agent definitions for automated crypto trading and portfolio management.

Topics

agent-apiagent-marketplaceai-agentsblockchainchatbotcryptocryptocurrencydefiethereumjson-apillmmulti-agentopen-sourcesmart-contractstrading-botsweb3yield-farmingagent-definitionsagent-indexmcp

README.md189 KBView on GitHub

🤖 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
✅ 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:

bash

# 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:

code

https://sperax.click/index.json

Or with language:

code

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

For Developers

bash

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:

code

- 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

bash

# 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

javascript

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

Fork this repository
Create your agent in src/your-agent-name.json

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.

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)

Fork/Clone this repository
Choose your domain option:
- Default GitHub Pages: Delete the CNAME file
- Custom Domain: Update CNAME with your domain
Enable GitHub Pages:
- Settings → Pages → Source: gh-pages branch
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

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.

Full Deployment Guide →

🔧 Development Tools

Split Agent Batches

bash

node split-agents.cjs

Converts batch JSON into individual agent files.

Emoji Converter

bash

node emoji-converter.cjs

Converts emoji URLs to native Unicode.

🌐 Integration Examples

Custom Application

javascript

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

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