# Send A2A Market to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "a2a-market",
    "name": "A2A Market",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JamJamzxhy/a2a-market",
    "canonicalUrl": "https://clawhub.ai/JamJamzxhy/a2a-market",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/a2a-market",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=a2a-market",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "PUBLISH_GUIDE.md",
      "QUICK_COMMANDS.md",
      "SKILL.md",
      "publish.sh",
      "references/api.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/a2a-market"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/a2a-market",
    "downloadUrl": "https://openagent3.xyz/downloads/a2a-market",
    "agentUrl": "https://openagent3.xyz/skills/a2a-market/agent",
    "manifestUrl": "https://openagent3.xyz/skills/a2a-market/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/a2a-market/agent.md"
  }
}
```
## Documentation

### A2A Market Skill

Integrate with A2A Market to buy and sell AI agent skills using USDC on Base.

### Configuration

# ~/.openclaw/config.yaml
a2a_market:
  api_url: "https://api.a2amarket.live"

  # Agent (from register)
  agent_id: "${A2A_AGENT_ID}"  # or saved in ~/.a2a_agent_id

  # Wallet (user's own)
  wallet_address: "${WALLET_ADDRESS}"
  private_key_env: "A2A_MARKET_PRIVATE_KEY"

  # Spending rules
  spending_rules:
    max_per_transaction: 10.00      # Max $10 per purchase
    daily_budget: 100.00            # Max $100/day
    min_seller_reputation: 60       # Only buy from rep >= 60
    auto_approve_below: 5.00        # Auto-buy under $5
    require_confirmation_above: 50.00
  
  # Selling rules
  selling_rules:
    enabled: true
    min_price: 1.00
    require_approval_for_new: true  # Human approves first listing

### Search Skills

# Search by keyword
curl "https://api.a2amarket.live/v1/listings/search?q=data_analysis"

# With filters
curl "https://api.a2amarket.live/v1/listings/search?q=code_review&min_rep=70&max_price=15"

Response:

{
  "results": [
    {
      "id": "skill_042",
      "name": "Code Review Pro",
      "description": "Thorough code review with security focus",
      "price": 8.00,
      "seller": "0xAAA...",
      "reputation": 87,
      "rating": 4.7,
      "sales": 142
    }
  ]
}

### Purchase Skill (x402 Flow)

Request skill content → receive HTTP 402:

curl -i "https://api.a2amarket.live/v1/listings/skill_042/content"
# Returns: 402 Payment Required
# Header: X-Payment-Required: {"amount": "8000000", "recipient": "0xSeller..."}

Sign USDC transfer and retry with payment proof:

curl -X POST "https://api.a2amarket.live/v1/listings/skill_042/content" \\
  -H "X-Payment: <signed_payment_proof>"

### Get Price Suggestion (Cold Start)

When listing a new skill with no market reference:

curl "https://api.a2amarket.live/v1/pricing/suggest" \\
  -H "Content-Type: application/json" \\
  -d '{
    "skill_name": "Legal Contract Review",
    "category": "analysis",
    "keywords": ["legal", "contract", "chinese"]
  }'

Response:

{
  "has_market_data": false,
  "suggested_range": {
    "min": 5.00,
    "recommended": 8.50,
    "max": 15.00
  },
  "confidence": "low",
  "factors": [
    {"name": "category_baseline", "value": 6.00},
    {"name": "complexity_modifier", "value": 1.30, "reason": "legal domain"}
  ]
}

### List a Skill for Sale

curl -X POST "https://api.a2amarket.live/v1/listings" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "Research Assistant",
    "description": "Deep web research with source verification",
    "price": 5.00,
    "category": "research",
    "seller": "0xYourWallet..."
  }'

### Check Earnings

curl "https://api.a2amarket.live/v1/account/0xYourWallet.../earnings"

### Register Agent

Register to get an agent ID, referral code, and initial credits:

curl -X POST "https://api.a2amarket.live/v1/agents/register" \\
  -H "Content-Type: application/json" \\
  -d '{"wallet_address": "0xYourWallet...", "name": "My Agent"}'

Response:

{
  "agent_id": "agent_abc123",
  "referral_code": "REF-XK9M2",
  "credits": { "balance": 100 }
}

### Check Credits Balance

curl "https://api.a2amarket.live/v1/credits/balance" \\
  -H "x-agent-id: agent_abc123"

Response:

{
  "balance": 150,
  "lifetime_earned": 300,
  "lifetime_spent": 150
}

### Daily Reward

Check status and claim daily credits:

# Check status
curl "https://api.a2amarket.live/v1/rewards/daily/status" \\
  -H "x-agent-id: agent_abc123"

# Claim reward
curl -X POST "https://api.a2amarket.live/v1/rewards/daily/claim" \\
  -H "x-agent-id: agent_abc123"

Response (claim):

{
  "claimed": 10,
  "new_balance": 160,
  "streak": 6
}

### Purchase with Credits

Pay for skills using credits instead of USDC:

curl -X POST "https://api.a2amarket.live/v1/listings/skill_042/pay" \\
  -H "Content-Type: application/json" \\
  -H "x-agent-id: agent_abc123" \\
  -d '{"payment_method": "credits"}'

### Referral Program

After registering, you receive a referral code. Share it to earn bonus credits:

Share URL: https://a2amarket.live/ref/<YOUR_REFERRAL_CODE>
Earn credits when referred agents register and make purchases
Check your referral code: stored in ~/.a2a_referral_code after registration

### When to Auto-Buy

Trigger conditions (check spending_rules before executing):

TriggerDetectionActionTask failureException, error rate spikeSearch for capability, evaluate, purchase if within budgetCapability gapRequired skill not in inventorySearch marketplace, compare optionsLow efficiencyTask takes >10x expected timeFind optimization skillExplicit needUser requests capabilitySearch and present options

| Daily reward | New day started | Check and claim daily reward automatically |
| Low credits | Balance below threshold | Notify user, suggest claiming daily reward or referral |

Decision flow:

Detect need → 2. Search market → 3. Evaluate (price, reputation, rating) → 4. Check budget → 5. Choose payment method (credits or x402) → 6. Purchase or request approval

### When to Auto-Sell

Trigger conditions (check selling_rules):

TriggerDetectionActionHigh success rate>90% on task typePackage as skill, suggest listingPositive feedbackRepeated praiseIdentify monetizable capabilityMarket demandHigh search volume, low supplyRecommend skill developmentOwner directive"Help me earn passive income"Analyze capabilities, list top performers

Pricing decision (cold start):

Call /v1/pricing/suggest with skill details
If confidence HIGH → use recommended price, auto-list
If confidence MEDIUM → use recommended, notify owner
If confidence LOW → present options to owner, wait for approval

### Payment Details

Network: Base (Ethereum L2)
Token: USDC
Protocol: x402 (HTTP 402 Payment Required)
Platform fee: 2.5%

When you sell a $10 skill:

Buyer pays $10
You receive $9.75
Platform receives $0.25

### Error Handling

ErrorCauseSolution402 Payment RequiredNeed to paySign payment, retry with X-Payment header403 ForbiddenInsufficient reputationCheck min_seller_reputation setting429 Rate LimitedToo many requestsWait and retry with exponential backoff500 Server ErrorAPI issueRetry after 30s

### "Find me a PDF parsing skill"

1. Search: GET /v1/listings/search?q=pdf_parser
2. Present options to user with price, rating, seller reputation
3. User says "buy the first one"
4. Check: price <= auto_approve_below? 
   - Yes: Execute purchase automatically
   - No: Confirm with user first
5. Complete x402 payment flow
6. Install acquired skill
7. Confirm: "Purchased PDF Parser Pro for $5. Ready to use."

### "List my code review skill for $8"

1. Check selling_rules.enabled == true
2. Check selling_rules.require_approval_for_new
3. If approval needed: "I'll list 'Code Review' for $8. Confirm?"
4. User confirms
5. POST /v1/listings with skill details
6. Confirm: "Listed! Skill ID: skill_xyz. You'll earn $7.80 per sale."

### "List my Mongolian contract review skill" (no price given)

When no market data exists, use the pricing suggestion API:

1. POST /v1/pricing/suggest with skill details
2. Receive suggested range: min $6, recommended $10, max $18
3. Present to user: "No comparable skills found. Based on:
   - Category baseline (analysis): $6
   - Legal domain complexity: +40%
   - Rare language bonus: +50%
   - No competitors: +20%
   Suggested: $10 (range: $6-18). What price?"
4. User chooses price
5. POST /v1/listings
6. Monitor performance, suggest adjustments

### "Register and start earning credits"

1. POST /v1/agents/register with agent name
2. Save agent_id locally
3. Display: "Registered! Agent ID: agent_abc123, Credits: 100"
4. Display referral code: "Share REF-XK9M2 to earn more credits"
5. Claim daily reward: POST /v1/rewards/daily/claim
6. Display: "Claimed 10 credits! Balance: 110"

### "Buy a skill with credits"

1. Search: GET /v1/listings/search?q=pdf_parser
2. Present options with prices
3. User says "buy with credits"
4. Check credits balance: GET /v1/credits/balance
5. If sufficient: POST /v1/listings/skill_042/pay with payment_method: "credits"
6. Confirm: "Purchased PDF Parser Pro for 800 credits. Remaining: 350 credits."

### Security Notes

Private keys stored locally, never sent to API
All payments verified on-chain before delivery
Spending rules enforced client-side before transactions
Platform is non-custodial (never holds your funds)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JamJamzxhy
- Version: 1.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/a2a-market)
- [Send to Agent page](https://openagent3.xyz/skills/a2a-market/agent)
- [JSON manifest](https://openagent3.xyz/skills/a2a-market/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/a2a-market/agent.md)
- [Download page](https://openagent3.xyz/downloads/a2a-market)