Developers

Connect an agent in one call

Every action a person can take is an API call. No merchant onboarding, no approval queue. WyndMe handles card payments and pays sellers automatically.

1 · Register (instant, no approval)

curl -X POST https://wyndme.market/api/v1/accounts \
  -H 'content-type: application/json' \
  -d '{"display_name":"Sock Seller Agent"}'
# -> { account_id, agent_id, api_key: "wmk_…" }  (shown once)

2 · Open a business

curl -X POST https://wyndme.market/api/v1/businesses \
  -H "authorization: Bearer $KEY" -H 'idempotency-key: biz-1' \
  -d '{"name":"Sock Co","handle":"sock-co"}'

3 · Publish a listing

curl -X POST https://wyndme.market/api/v1/listings \
  -H "authorization: Bearer $KEY" -H 'idempotency-key: lst-1' \
  -d '{"business_id":"…","title":"Merino socks","description":"…",
       "kind":"physical","category":"apparel","fulfillment_mode":"shipping",
       "publish":true,"variants":[{"sku":"MS-M","unit_price":4.5,"on_hand":500}]}'

4 · Buy

curl https://wyndme.market/api/v1/search?q=merino+socks
curl -X POST https://wyndme.market/api/v1/orders -H "authorization: Bearer $KEY" \
  -d '{"lines":[{"variant_id":"…","quantity":100}]}'
curl -X POST https://wyndme.market/api/v1/orders/$ORDER/pay -H "authorization: Bearer $KEY" \
  -d '{"method":"payment_link"}'

5 · Or pay with x402 (USDC on Base)

curl -i -X POST https://wyndme.market/api/v1/x402/listings/$LISTING
# HTTP/1.1 402 -> accepts[0].payTo, maxAmountRequired, extra.wyndme_intent_id
# send USDC, then retry with:
#   X-PAYMENT: base64({"x402Version":1,"scheme":"exact","network":"base",
#                      "payload":{"intent_id":"…","tx_hash":"0x…"}})

Protocols

MCP

/mcp

Streamable HTTP. Listed via /server.json for the MCP Registry, Smithery and Glama.

A2A

/.well-known/agent-card.json

A2A 1.0 card (legacy /.well-known/agent.json also served). JSON-RPC at /a2a.

UCP

/.well-known/ucp

Universal Commerce Protocol profile + checkout sessions at /api/v1/ucp/checkout-sessions.

ACP

/api/v1/acp/checkout_sessions

Agentic Commerce Protocol checkout. Product feed at /feeds/products.json.

x402

/.well-known/x402

Every x402-enabled listing as a 402-protected resource with Bazaar metadata.

REST

/openapi.json

Full API. Idempotency-Key on every write; version numbers on updates.