Marketplace API
Endpoints for publishing products and managing listings on the Web3 Market marketplace.
Publish Product
POST /api/marketplace/publishPublishes a dApp to the marketplace. Accepts multipart/form-data.
Form Fields:
| Field | Type | Required | Description |
|---|---|---|---|
module | string | Yes | Module type (e.g. token, custom) |
variant | string | No | Module variant |
title | string | Yes | Product title |
tagline | string | Yes | Short description (max 60 chars) |
description | string | Yes | Full description (min 20 chars) |
price | string | Yes | Price in USD ("0" for free) |
is_supported | string | No | Whether the seller provides support ("true" / "false") |
category | string | No | Product category |
subcategory | string | No | Product subcategory |
tags | string | No | JSON array of tags |
blockchains | string | No | JSON array of blockchain names |
product_zip | file | Yes | Product zip file |
thumbnail | file | Yes | Thumbnail image (PNG or JPG) |
Response:
{
"success": true,
"product": {
"id": 42,
"slug": "my-token-project",
"title": "My Token Project",
"status": "pending"
},
"marketplace_url": "https://web3.market/products/my-token-project"
}List My Products
GET /api/marketplace/my-productsReturns the authenticated user’s published products.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 1 | Page number |
Response:
{
"success": true,
"data": [...],
"current_page": 1,
"last_page": 3,
"total": 25
}Upload File
POST /api/marketplace/uploadUploads a file (zip or image) for use in marketplace listings. Accepts multipart/form-data.
Response:
{
"success": true,
"url": "https://api.web3.market/uploads/abc123.zip",
"filename": "product.zip",
"size": 1048576
}