> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swarms.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Quick reference for all Swarms Marketplace APIs - endpoints, methods, and authentication requirements

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

| 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 |
| - | - | - | - | - |
| **Products** | `/api/product/list` | GET | Yes | List all products you've posted (agents, prompts, tools, bundles) |
| **Products** | `/api/product/fees` | GET | Yes | Check creator fees generated by a tokenized product |
| **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 |
| **Bundles** | `/api/v1/publish/bundle` | POST | Yes | Publish a bundle (curated collection of agents/prompts) |
| **Token Launch** | `/api/token/launch` | POST | Yes | Create agent and launch token on Solana |
| **Token Launch** | `/api/token/launch/batch` | POST | Yes | Launch up to 50 tokenized agents in one request |
| **Reviews** | `/api/reviews` | POST | Yes | Submit a rating and review for an agent, prompt, or tool |
| **Claim Fees** | `/api/product/claimfees` | POST | No | Claim accumulated creator fees |

***

## 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](https://swarms.world/platform/api-keys).

***

## Marketplace API Categories

### Products API

Read your own marketplace catalog and the fees your tokenized products have earned.

| Endpoint | Method | Auth | Purpose |
| - | - | - | - |
| `/api/product/list` | GET | Required | List all products you've posted (agents, prompts, tools, bundles) with name, description, time posted, and public URL |
| `/api/product/fees` | GET | Required | Check creator fees (via Jupiter) generated by a tokenized product, by ticker, UUID, or URL |

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

<CardGroup cols={2}>
  <Card title="List Products API" icon="list" href="/docs/marketplace/list-products-api">
    List all products you've posted
  </Card>

  <Card title="Product Fees API" icon="coins" href="/docs/marketplace/product-fees-api">
    Check creator fees for a tokenized product
  </Card>
</CardGroup>

***

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

**Key Features:**

* Support for free and paid agents
* Automatic content validation and quality assessment
* Blockchain tokenization support
* Rate limit: 3 paid agents/day per user (500/day for free agents)

<Card title="Full Documentation" icon="book" href="/docs/marketplace/agents-api">
  View complete Agents API reference with examples
</Card>

***

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

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

<Card title="Full Documentation" icon="book" href="/docs/marketplace/prompts-api">
  View complete Prompts API reference with examples
</Card>

***

### Bundles API

Publish [bundles](/docs/marketplace/bundles) — curated collections of marketplace agents, prompts, and custom inline prompts — programmatically.

| Endpoint | Method | Auth | Purpose |
| - | - | - | - |
| `/api/v1/publish/bundle` | POST | Required | Publish a bundle with 1–50 items (marketplace references and/or inline prompts) |

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

<Card title="Full Documentation" icon="book" href="/docs/marketplace/bundles-api">
  View complete Bundles API reference with examples
</Card>

***

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

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

<Card title="Full Documentation" icon="book" href="/docs/marketplace/token-launch-api">
  View complete Token Launch API reference with examples
</Card>

***

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

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

<Card title="Full Documentation" icon="book" href="/docs/marketplace/claim-fees-api">
  View complete Claim Fees API reference with examples
</Card>

***

## HTTP Status Codes

| Code | Meaning |
| - | - |
| `200` | Success |
| `400` | Bad Request - validation errors or invalid parameters |
| `401` | Unauthorized - missing or invalid API key |
| `403` | Forbidden - paid content without access |
| `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 | 3/day (15/day for VIP accounts) | Midnight |
| Paid Prompts | 500/day | Midnight |
| Free Content | 500/day | Midnight |

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

***

## Related Resources

<CardGroup cols={2}>
  <Card title="List Products API" icon="list" href="/docs/marketplace/list-products-api">
    List all products you've posted
  </Card>

  <Card title="Product Fees API" icon="coins" href="/docs/marketplace/product-fees-api">
    Check creator fees for a tokenized product
  </Card>

  <Card title="Agents API" icon="robot" href="/docs/marketplace/agents-api">
    Complete reference for agent management
  </Card>

  <Card title="Prompts API" icon="file-lines" href="/docs/marketplace/prompts-api">
    Complete reference for prompt management
  </Card>

  <Card title="Token Launch API" icon="rocket" href="/docs/marketplace/token-launch-api">
    Launch tokenized agents on Solana
  </Card>

  <Card title="Claim Fees API" icon="coins" href="/docs/marketplace/claim-fees-api">
    Claim your creator fees
  </Card>

  <Card title="Examples" icon="code" href="/docs/marketplace/examples">
    Real-world integration examples
  </Card>

  <Card title="Creator Fees" icon="percent" href="/docs/marketplace/creator-fees">
    Understand the fee structure
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.