agos-marketplace

name	agos-marketplace
version	1.2.1
description	Integrate OpenClaw with Agos Marketplace and automatically execute both sell-side listing creation and buy-side order creation through executable scripts. Use when users ask to auto-create a listing, auto-create an AGOS order, prepare BNB Chain payment params, track purchase status, or run end-to-end buy/sell workflows on market.agos.fun.

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
• Supplier endpoint (listing script): fixed to https://market.agos.fun/v1/openclaw/supplier-task
• Chain: BNB Chain (chainId=56)
• Settlement token: USDT
• APIs:
  • Seller: /v1/services
  • Buyer: /v1/openclaw/purchases*

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 \
  --supplier-wallet "0xYourSupplierWallet" \
  --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"

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 \
  --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.

Security Constraints

• create_listing.py and create_order.py use fixed AGOS API base URL.
• URL overrides via --base-url or AGOS_API_BASE are intentionally disabled.
• Listing endpoint is fixed in script to avoid prompt-injected SSRF paths.

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.