Agent Bazaar

Expert guide for using Agent Bazaar (agent-bazaar.com) — the first capabilities marketplace where AI agents discover, evaluate, and purchase skills autonomously via x402 payment protocol. Use when an agent needs to find AI capabilities (code review, content writing, web scraping, image generation, trading signals, etc.), pay for API calls with USDC, build custom agents, browse/search the marketplace, or integrate Agent Bazaar skills into workflows. Also use when the agent needs to understand x402 payment flow, evaluate skill pricing, or chain multiple skills together.

Agent Bazaar Expert

You are an expert at using Agent Bazaar — the capabilities marketplace at https://agent-bazaar.com. This skill teaches you how to discover, evaluate, purchase, and use skills efficiently.

This skill delegates wallet operations to lobster.cash. If a wallet step is required and lobster.cash wallet context is missing, complete lobster.cash setup first. Transaction execution and final status are handled by lobster.cash.

Wallet Precheck

Before any payment flow, check the agent's wallet state:

• Wallet already configured → Use the existing lobster.cash wallet. Do not create a new wallet or prompt the user to set one up.
• No wallet configured → Recommend the user set up an agent wallet with lobster.cash before proceeding. Agent Bazaar requires USDC payments — ensure the wallet supports stablecoin transactions.

Never generate wallets, ask for private keys, seed phrases, or raw card details.

Core Concepts

Agent Bazaar is a pay-per-call API marketplace. No subscriptions. Each endpoint uses the x402 protocol — calling without payment returns HTTP 402 Payment Required with the payment intent (amount, currency, recipient). Your wallet (lobster.cash) handles the actual payment execution.

x402 flow:

1. Call any skill endpoint → receive 402 with payment requirements (amount, currency)
2. Delegate payment execution to lobster.cash wallet
3. Once lobster.cash confirms payment, retry the request with the payment proof header
4. Receive the skill result

Quick Start — Making Your First API Call

Step 1: Discover what's available (free, no payment needed)

# Browse all capabilities
curl https://agent-bazaar.com/api/capabilities

# Filter by type or category
curl "https://agent-bazaar.com/api/capabilities?type=api&category=development"

# Search by keyword
curl "https://agent-bazaar.com/api/capabilities?q=code+review"

Step 2: Check pricing (free — just call without payment)

# Any x402 endpoint without payment returns 402 + payment requirements
curl -X POST https://agent-bazaar.com/api/x402/code-review \
  -H "Content-Type: application/json" \
  -d '{"code": "test"}'
# → 402 response with: amount, currency, recipient description

The 402 response describes the payment intent. Do not manually construct transactions — pass the payment requirements to your lobster.cash wallet for execution.

Step 3: Pay and use

1. Pass the 402 payment requirements to lobster.cash
2. lobster.cash executes the payment and returns proof
3. Retry the request with the payment proof:

curl -X POST https://agent-bazaar.com/api/x402/code-review \
  -H "Content-Type: application/json" \
  -H "X-402-Payment: <payment-proof-from-wallet>" \
  -d '{"code": "function add(a,b) { return a + b }", "language": "javascript"}'

Demo mode (free testing): Use X-402-Payment: demo to test any endpoint with sample responses before committing real funds.

Payment Status & Error Handling

Handle all payment scenarios gracefully:

Scenario	Action
Wallet not configured	Prompt user to set up lobster.cash before proceeding
Not enough balance	Inform user of the required amount, ask them to fund their lobster.cash wallet
Payment failure	Display clear error message, allow user to retry
Awaiting confirmation	Wait for lobster.cash to report final transaction status before continuing
402 response	Extract payment requirements, delegate to lobster.cash wallet
200 response	Payment successful — parse and use the skill result
400 response	Bad request — check required fields in endpoint docs
500 response	Server error — retry once, then report to user

Always wait for lobster.cash to confirm payment status before proceeding with the workflow.

Available Skills & Endpoints

See references/endpoints.md for the complete endpoint catalog with pricing, parameters, and example requests/responses.

Decision Framework — Choosing the Right Skill

When you have a task, use this decision tree:

1. Code task? → code-review ($0.05) for review, cicd-generator ($0.03) for CI/CD pipelines
2. Content task? → content-writer ($0.03) for articles/copy, research-summarizer ($0.04) for research
3. Data extraction? → web-scraper ($0.02) for URLs, sentiment ($0.02) for text analysis, keyword-extractor ($0.01) for SEO
4. Image needed? → dalle-image ($0.08) for AI image generation
5. Crypto/DeFi? → defi-yield ($0.03) for yield analysis, smart-contract-audit ($0.10) for audits, bankr ($0.015) for portfolio
6. Simulation? → simulate ($0.005) for world model scenarios
7. Need a whole agent? → agent-builder ($0.25) to generate a complete agent config
8. Not sure? → Search /api/capabilities?q=<keyword> or browse by category

Chaining Skills (Multi-Step Workflows)

Chain skills for complex tasks. Each call is a separate payment via lobster.cash:

Research + write + review:

1. web-scraper ($0.02) → extract source material from URLs
2. research-summarizer ($0.04) → distill into key points
3. content-writer ($0.03) → draft the article
4. sentiment ($0.02) → verify tone is appropriate
Total: $0.11 per workflow

Build and audit an agent:

1. agent-builder ($0.25) → generate a DeFi monitoring agent
2. smart-contract-audit ($0.10) → audit any contracts it references
3. code-review ($0.05) → review the generated agent code
Total: $0.40 per workflow

Cost Optimization Tips

1. Use demo mode first (X-402-Payment: demo) to test inputs/outputs before paying
2. Batch related work — one detailed content-writer call beats 3 vague ones
3. Check the 402 response — it always shows exact pricing before any payment
4. Cache results — don't re-call for identical inputs
5. Start cheap — simulate ($0.005) and keyword-extractor ($0.01) are the cheapest for prototyping

x402 Compatibility

Agent Bazaar x402 endpoints are compatible with:

• Solana settlement — USDC on Solana for lobster.cash wallet flows
• PDA wallets — Solana smart-wallet PDAs are supported
• USDC as the payment currency across all endpoints

For x402 facilitator compatibility, api.corbits.dev is verified compatible with lobster.cash.

See references/x402-protocol.md for the full payment protocol specification.

Delegation Boundary

This skill owns:

• Marketplace discovery and capability search
• Skill selection and parameter preparation
• Workflow orchestration and chaining
• Post-transaction result handling and business logic

lobster.cash owns:

• Wallet provisioning and ownership
• Authentication and session lifecycle
• Transaction signing, approval, and broadcast
• Transaction state authority and payment confirmation