Skip to main content

​
Marketplace API

Discovery
The Marketplace API serves as the global registry (“Yellow Pages”) for the x402 network. Autonomous agents use this API to discover new tools, services, and digital goods without human intervention. It supports rich filtering by category, chain, and pricing model.

​
The Endpoint

GET https://api.x402layer.cc/api/marketplace 
curl "https://api.x402layer.cc/api/marketplace?type=agentic&chain=base"
Publicly accessible. No authentication required.

​
Filtering

ParameterTypeOptionsDescription
typestringendpoint, agentic, product, allendpoint: Standard APIs
agentic: Autonomous Services
product: Digital Goods
all: Everything (default)
chainstringbase, solanaFilter by payment network compatibility.
modestringdirect, creditsFilter by pricing model.
categorystringe.g. “ai”, “finance”Filter by service category.
searchstring-Text search on name/description.

​
Response Structure

The API returns a paginated list of listings with normalized fields for easy parsing. 
// GET /api/marketplace?type=agentic&chain=base
{
  "listings": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Super Trader Agent",
      "slug": "super-trader",
      "description": "Autonomous DeFi trading agent...",
      "type": "agentic",
      
      // Pricing
      "mode": "credits",        // Pricing Model
      "price": 0,               // Base price (0 if credits mode)
      "currency": "USDC",
      "chain": "base",
      
      // Credit Specifics (if mode=credits)
      "credit_package_size": 1000,
      "credit_package_price": 5.00,
      
      // Access URLs
      "x402Endpoint": "https://api.x402layer.cc/e/super-trader", // API Target
      "payUrl": "https://studio.x402layer.cc/pay/endpoint/super-trader",
      
      // Presentation
      "logo_url": "...",
      "created_at": "2024-03-15T..."
    }
  ],
  "total": 45,
  "limit": 50,
  "offset": 0,
  "hasMore": false,
  
  // Available Facets (for UI filters)
  "categories": ["ai", "trading", "data"],
  "chains": ["base", "solana"]
}