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
/api/v1/agentsList all published agents. Supports filtering by category, price range, and rating. Paginated.
/api/v1/agents/:idGet full details for a single agent listing including description, reviews, install count, and seller profile.
/api/v1/agentsSubmit a new agent listing for review. Requires Creator or Team plan. Body includes name, description, category, price, and agent package.
/api/v1/categoriesList all marketplace categories with agent counts. Currently: Productivity, Development, Customer Support, Creative.
/api/v1/agents/:id/installInstall an agent. Returns a signed download URL. Tracks install count and buyer association.
/api/v1/agents/:id/reviewsList 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).
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