DeFi Trading 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.

Live API: sperax.click/index.json · Docs: sperax.click/docs · Use the agents: chat.sperax.io

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 - Cloudflare Pages at sperax.click 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 run in production at chat.sperax.io. 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://sperax.click/index.json

Individual agent (English)

GET https://sperax.click/{agent-id}.json

Localized agent

GET https://sperax.click/{agent-id}.zh-CN.json

Language-specific index

GET https://sperax.click/index.zh-CN.json

Quick Integration

// Load all agents

const response = await fetch('https://sperax.click/index.json'); const { agents } = await response.json();

// Load specific agent const agent = await fetch(https://sperax.click/defi-yield-farmer.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 }

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
• Cloudflare Pages - How sperax.click is deployed
• Prompt Engineering - Writing better prompts
• Model Parameters - Temperature, top_p explained
• Troubleshooting - Common issues

---

🚀 Deployment

Production: Cloudflare Pages

sperax.click is served by the Cloudflare Pages project sperax-click. The / path redirects to the docs at sperax.click/docs/.

bun install

bun scripts/commands/build.ts # writes agent JSON for every locale to ./public bash scripts/build-site.sh # assembles ./_site (agents, docs, schema, llms.txt, _headers) npx wrangler pages deploy _site --project-name sperax-click --branch main

.github/workflows/cloudflare-pages.yml runs the same steps on every push to main. It needs the CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID repository secrets. Hosting a fork on your own domain is covered in docs/deploy-cloudflare.md.

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://sperax.click/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://sperax.click/index.json') agents = response.json()['agents']

Filter by tag

defi_agents = a for a in agents if 'defi' in a['meta']

---

🔐 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

Proprietary - Copyright 2026 nirholas. All rights reserved. See the LICENSE file for the full terms; use beyond what that file permits requires written permission from the copyright owner.

Open Format • Portable Agents • No Vendor Lock-in

---

Sperax Portfolio

By [@sperax](https://github.com/nirholas/AI-Agents-Library) 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 **[@