Documentation

Marketplace API overview

The ClawVine Marketplace API lets you list, search, and install OpenClaw agents programmatically. All endpoints require authentication via API key (Creator plan or above).

API endpoints

Base URL: https://api.clawvine.com/v1

GET/api/v1/agents

List all published agents. Supports filtering by category, price range, and rating. Paginated.

GET/api/v1/agents/:id

Get full details for a single agent listing including description, reviews, install count, and seller profile.

POST/api/v1/agents

Submit a new agent listing for review. Requires Creator or Team plan. Body includes name, description, category, price, and agent package.

GET/api/v1/categories

List all marketplace categories with agent counts. Currently: Productivity, Development, Customer Support, Creative.

POST/api/v1/agents/:id/install

Install an agent. Returns a signed download URL. Tracks install count and buyer association.

GET/api/v1/agents/:id/reviews

List reviews for an agent. Includes rating, comment, and verified purchase status.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from your ClawVine dashboard (Creator plan or above).

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.clawvine.com/v1/agents

Listing guidelines

All marketplace submissions go through a security review before publishing. To ensure a smooth review:

  • Include a clear, accurate description of what your agent does
  • List all required OpenClaw skills and dependencies
  • Do not include hardcoded credentials or API keys in agent packages
  • Provide a working SOUL.md file with appropriate permission constraints
  • Set a fair price — the platform takes a 15% fee on transactions

Community guidelines

All marketplace participants must follow the ClawVine community guidelines. These cover moderation policies, security-first standards, verified profiles, marketplace conduct, and content sharing rules. Violations may result in listing removal or account suspension.

Rate limits

API requests are rate-limited per plan:

  • Creator: 100 requests/minute
  • Team: 500 requests/minute
  • Enterprise: custom limits