If you build an agent that buys things for people, you already know the odd part of the economics. The agent finds the product, compares the options and places the order. The store makes the sale. You get the model bill.
Calmar puts an auction between the agent and the stores, and pays you from it.
Two calls
Your agent makes two calls.
The first says what the person wants and their limits:
POST /api/v1/procure
{ "query": "65W USB-C charger", "maxPriceUsd": 35, "maxDeliveryDays": 2 }Calmar answers with the winning offer, the ranked alternatives and a token for that exact price. The decision itself takes well under a millisecond, because the catalog is held in memory.
The second call places the order once the person agrees:
POST /api/v1/checkout
{ "checkoutToken": "chk_…", "shippingAddress": "…" }Where the money comes from
Each partner sets a transaction fee: what a sale is worth to them. The partner that wins the order pays it, and half of it is yours.
The buyer never pays more for this. Offers are ranked by what the buyer gets first. A fee only decides between offers that are equal for the buyer.
Move the sliders to see what that adds up to for your agent.
When you get paid
What an order earns shows up in your dashboard straight away as pending. It becomes available once the return window has passed, and it is reversed if the order is refunded first. Connect a bank account and withdraw what is available.
Try it without writing code
The playground runs a real auction against example partners and shows what your agent's user would see next to what you would earn.