Commerce

These actions move real money and real atoms: paper in the mail, wine on a truck, another agent doing work for you. Vaaya settles with each merchant per call. There are no vendor accounts or API keys to set up. Browsing and quoting are free; you pay when you commit.

What you can do

Action	What it does	Price
`agentfax/send`	Send a real fax to any phone number.	$0.20 per page
`papercut/send`	Mail a comedy-roast postcard of a GitHub profile.	$1 digital, $3 physical
`postalform/order`	Print and mail letters and documents.	Varies, quoted first
`martin-estate/purchase`	Buy estate-grown Napa Valley wine.	Catalog price
`sayer-and-stone/purchase`	Buy made-to-order lab-grown diamond jewelry.	Catalog price
`autoexchange/run`	Hire another agent from a marketplace.	Varies by agent

The spending rule

Purchases with variable ticket sizes require an explicit max_cost_cents in the request. A call without one is rejected with max_cost_required and nothing runs. The ceiling you pass becomes the settle cap for that call. Set it to the total you confirmed, and confirm the item and total with your user before you buy.

Faxes

agentfax/send takes a phone number and a public PDF URL. The merchant prices by page count, at $0.20 per page with a 10-page cap.

curl -X POST https://vaaya.ai/api/run/agentfax/send \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+14155550123", "file_url": "https://example.com/contract.pdf"}'

Postcards

Papercut mails a postcard with a roast of a GitHub profile, written by your agent. Fetch the profile first with papercut/github-profile (free), write the roast from that data, then send.

The roast is 280 characters max, all lowercase, funny rather than cruel. No secrets, emails, URLs, or file paths.
type is digital ($1) or physical ($3). Physical needs a full mailing address.
The response has a reveal link and a referral link. Show those, not the roast text. Art takes about a minute.

Printed mail

PostalForm prints and mails real documents. Always quote first: postalform/validate (free) takes the same body as postalform/order and returns the price and any validation errors. Confirm the quote, then order. Poll the order id in the response for fulfillment status.

Wine and jewelry

Two merchants sell physical goods with an agent-native checkout. Browse with the free catalog action, then purchase with the product, quantity, buyer email, and a US shipping address. Tax is calculated from the shipping state.

martin-estate: estate-grown Napa Valley wine. US only, and the buyer must pass a 21+ identity check. A 403 with a verify_url means the human completes verification, then you retry the purchase with the returned order_id.
sayer-and-stone: made-to-order lab-grown diamond jewelry. Order by sku, or by product_slug plus options like length and metal. Delivery estimates arrive by email.
Both accept an optional gift_note (plain text, up to 300 characters, line breaks preserved on the printed card).

Hiring other agents

Auto.exchange is a marketplace of agents for coding, design, research, and more. Search it free with autoexchange/search, then run one with autoexchange/run and the agent id. Price varies by agent and token usage, roughly $0.0006 to $0.075 per 1k tokens.