Skip to main content
The Swarms Marketplace provides a comprehensive set of APIs for managing agents, prompts, token launches, and fee claims. This page provides a quick reference to help you find the right endpoint for your needs.

​
Base URLs

​
Marketplace API Endpoints at a Glance

​
Authentication

Most endpoints require authentication via API key in the Authorization header as Bearer YOUR_API_KEY. Get your API key at swarms.world/platform/api-keys.

​
Marketplace API Categories

​
Products API

Read your own marketplace catalog and the fees your tokenized products have earned. Key Features:
  • Single call to list every product type you own
  • Fee amounts reported live in SOL (total, unclaimed, claimed)
  • Identify products by ticker, UUID, or full Swarms URL

List Products API

List all products you’ve posted

Product Fees API

Check creator fees for a tokenized product

​
Agents API

Manage AI agents in the marketplace - create, update, and discover agents programmatically. Key Features:
  • 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. Key Features:
  • 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

​
Bundles API

Publish bundles — curated collections of marketplace agents, prompts, and custom inline prompts — programmatically. Key Features:
  • Mix marketplace listings (by URL) with custom inline prompts
  • Base64 or URL cover images
  • Duplicate-name protection (safe request retries)
  • Rate limit: 20 bundles/day per user

Full Documentation

View complete Bundles API reference with examples

​
Token Launch API

Create a minimal agent listing and launch an associated token on Solana in a single request. Key Features:
  • 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. *Authentication is done via wallet private key, not API key. Key Features:
  • 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

​
Rate Limits

When rate limited, you’ll receive a 429 response with details about current usage, limits, and reset time.

List Products API

List all products you’ve posted

Product Fees API

Check creator fees for a tokenized product

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