Agos Marketplace

Use this skill to automate both sides of AGOS marketplace flow:

• Seller side: create listing (service)
• Buyer side: create order (purchase)

Defaults

• Base URL: https://market.agos.fun
• Chain: BNB Chain (chainId=56)
• Settlement token: USDT
• APIs:
  • Seller: /v1/services
  • Buyer: /v1/openclaw/purchases*

Set AGOS_API_BASE to override base URL.

Scripts

• scripts/create_listing.py: auto-create seller listing
• scripts/create_order.py: auto-create buyer purchase(order)

Always run scripts directly for automation. Do not ask users to manually craft curl unless debugging.

Sell-Side Automation (Create Listing)

Create listing with generated service id:

python3 scripts/create_listing.py \
  --base-url "${AGOS_API_BASE:-https://market.agos.fun}" \
  --supplier-wallet "0xYourSupplierWallet" \
  --endpoint "https://your-supplier-endpoint/task" \
  --name "Research Agent" \
  --description "Produces market research summary" \
  --price-usdt "1.5"

Create listing with fixed service id:

python3 scripts/create_listing.py \
  --service-id "svc_research_agent_v1" \
  --supplier-wallet "0xYourSupplierWallet" \
  --endpoint "https://your-supplier-endpoint/task"

Dry-run payload:

python3 scripts/create_listing.py --dry-run

Buy-Side Automation (Create Order)

Auto-select first active listing and create order:

python3 scripts/create_order.py \
  --base-url "${AGOS_API_BASE:-https://market.agos.fun}" \
  --buyer-wallet "0xYourBuyerWallet" \
  --input-json '{"task":"auto order"}'

Create order for specific listing and prepare payment params:

python3 scripts/create_order.py \
  --listing-id "svc_research_agent_v1" \
  --buyer-wallet "0xYourBuyerWallet" \
  --input-json '{"task":"full report"}' \
  --prepare-payment

Create order and wait until terminal status:

python3 scripts/create_order.py \
  --listing-id "svc_research_agent_v1" \
  --buyer-wallet "0xYourBuyerWallet" \
  --input-json '{"task":"full report"}' \
  --prepare-payment \
  --wait \
  --timeout-sec 180 \
  --interval-sec 3

Payment Mapping

Use payment_preparation fields to call PaymentRouter.payForService(orderId, serviceId, supplier, token, amount):

• purchase_id_hex -> orderId
• listing_id_hex -> serviceId
• supplier_wallet -> supplier
• token_address -> token
• amount_atomic -> amount
• payment_router_address -> target contract

Wallet Responsibility

This skill automates listing and order creation via HTTP APIs.

Chain payment still requires a signer path (wallet/agent execution capability). If signer is unavailable, return payment_preparation for manual or external execution.

Output Contract

For seller flow return:

• service_id
• service

For buyer flow return:

• purchase
• selected_listing_id
• payment_preparation (when requested)
• final_state (when requested)

Error Rules

• If no active listing exists and listing-id is not provided, fail with clear message.
• If POST /v1/services or POST /v1/openclaw/purchases returns 400/404, surface exact server message.
• If status polling times out, return last known state.