Base URLs
| Service | Base URL |
|---|---|
| Marketplace API | https://swarms.world |
| Swarms API | https://api.swarms.world |
Marketplace API Endpoints at a Glance
| API | Endpoint | Method | Auth Required | Description |
|---|---|---|---|---|
| Agents | /api/add-agent | POST | Yes | Create a new agent listing |
| Agents | /api/edit-agent | POST | Yes | Update an existing agent |
| Agents | /api/query-agents | POST | No | Search and filter agents |
| Prompts | /api/add-prompt | POST | Yes | Create a new prompt |
| Prompts | /api/edit-prompt | POST | Yes | Update an existing prompt |
| Prompts | /api/query-prompts | POST | No | Search and filter prompts |
| Token Launch | /api/token/launch | POST | Yes | Create agent and launch token on Solana |
| Claim Fees | /api/product/claimfees | POST | No | Claim accumulated creator fees |
Authentication
Most endpoints require authentication via API key in theAuthorization header as Bearer YOUR_API_KEY.
Get your API key at swarms.world/platform/api-keys.
Marketplace API Categories
Agents API
Manage AI agents in the marketplace - create, update, and discover agents programmatically.| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/api/add-agent | POST | Required | Create a new agent with code, description, pricing, and metadata |
/api/edit-agent | POST | Required | Update agent details (requires agent id) |
/api/query-agents | POST | Optional | Search agents by keyword, category, price, and more |
- Support for free and paid agents
- Automatic content validation and quality assessment
- Blockchain tokenization support
- Rate limit: 500 agents/day per user
Full Documentation
View complete Agents API reference with examples
Prompts API
Manage AI prompts in the marketplace - create reusable prompt templates and discover existing prompts.| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/api/add-prompt | POST | Required | Create a new prompt with use cases and metadata |
/api/edit-prompt | POST | Required | Update prompt details (requires prompt id) |
/api/query-prompts | POST | Optional | Search prompts by keyword, category, price, and more |
- Use prompts directly with agents via
marketplace_prompt_id - Automatic USD to SOL price conversion
- Content safety and quality validation
- Rate limit: 500 prompts/day per user
Full Documentation
View complete Prompts API reference with examples
Token Launch API
Create a minimal agent listing and launch an associated token on Solana in a single request.| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/api/token/launch | POST | Required | Create agent + launch Solana token (~0.04 SOL cost) |
- Single request for agent creation and tokenization
- Supports JSON and multipart/form-data (for image upload)
- Multiple private key formats (JSON array, base64, base58)
- Returns token address and pool address
Full Documentation
View complete Token Launch API reference with examples
Claim Fees API
Claim accumulated creator fees for tokenized agents on Solana.| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/api/product/claimfees | POST | No* | Claim fees (requires wallet private key) |
- Claim accumulated SOL fees
- Returns transaction signature and amount claimed
- Detailed fee breakdown (unclaimed, claimed, total)
- Private key used only in memory, never stored
Full Documentation
View complete Claim Fees API reference with examples
HTTP Status Codes
| Code | Meaning |
|---|---|
200 | Success |
400 | Bad Request - validation errors or invalid parameters |
401 | Unauthorized - missing or invalid API key |
403 | Forbidden - content validation failed |
404 | Not Found |
405 | Method Not Allowed |
429 | Too Many Requests - rate limit exceeded |
500 | Internal Server Error |
Rate Limits
| Resource | Limit | Reset |
|---|---|---|
| Paid Agents | 500/day | Midnight UTC |
| Paid Prompts | 500/day | Midnight UTC |
| Free Content | 500/day | Midnight UTC |
429 response with details about current usage, limits, and reset time.
Related Resources
Agents API
Complete reference for agent management
Prompts API
Complete reference for prompt management
Token Launch API
Launch tokenized agents on Solana
Claim Fees API
Claim your creator fees
Examples
Real-world integration examples
Creator Fees
Understand the fee structure