Introduction
What Sangria does, how buying works, and how your account — credits, spend limits, agents, and delivery — fits together.
Quickstarts
Quickstart sets up your account first.
What Sangria is
Sangria lets your AI agents buy things for you and pay automatically. No crypto wallets, no signing, no per-merchant integrations. Your agent describes what it wants, you approve a price, and Sangria places the order and settles up from a pre-funded credit balance.
Today that means physical products from Amazon, on the marketplace for your country: Sangria supports the United States and Singapore. Some categories aren't supported, and those requests are refused before anything is charged.
How it works
Buying through Sangria is two steps:
- Discover — your agent describes what it wants. Sangria searches what's available and returns a short-lived, price-locked quote with up to 5 candidate matches. Each match carries the item price before tax, an estimated tax, and an estimated total.
- Buy — your agent commits one match. Sangria holds the total against your balance, places the order with the merchant, and charges you once the merchant confirms — then hands back the merchant's response.
Your agent never talks to a merchant or signs a payment. Sangria hides all the payment plumbing behind a small HTTP API and pays merchants on your behalf from your credit balance.
Your account
However you use it, Sangria spends from one account: the same credits, the same limits, the same delivery address. You manage all of it from your dashboard.
Credits and top-ups
Sangria spends from credits you fund ahead of time. There's no card charged at checkout and no overdraft: if your balance won't cover a purchase, the purchase is refused rather than partly paid.
- Add credits from your dashboard — the Top Up button sits next to your balance.
- Manage your saved card in Settings.
Searching is free. A completed buy debits your credits, and a purchase the merchant declines costs you nothing.
Spend limits
Every agent carries a daily and a monthly cap, and the two are counted over rolling windows — the last 24 hours and the last 30 days, not calendar days or months. A purchase that would push either window past its cap is refused.
Three things worth knowing:
- The caps include tax. They're measured against the tax-inclusive total, the same number your credits are charged.
- A refused purchase costs nothing. Nothing is bought, nothing is debited.
- Topping up does not lift a cap. The limit is a guardrail on the agent, not a statement about your balance — adding credits changes nothing. Raise the cap, or wait for older purchases to fall out of the window.
Caps are editable per agent from the dashboard, and either one can be set to unlimited.
Agents
Everywhere else on this page, "your agent" is the AI doing the shopping. Here it's the credential that AI spends through: one key, with its own limits and its own order history. You'll have at least one for each way you use Sangria — a chat gets its own per conversation, and you can mint as many dashboard keys as you like.
| Kind | Created when | Removing it |
|---|---|---|
| Dashboard agent | You create a key yourself, for the CLI or direct API use | Revoke it from the dashboard |
| Connector agent | You connect Sangria to an assistant like Claude or ChatGPT | Disconnect the connector in the app you connected from |
| Chat agent | You connect a chat | Disconnect from the dashboard — it removes that chat only, and leaves your other chats connected |
You hold the key for a dashboard agent, so you can revoke it, and a chat agent has its own off switch on the dashboard. A connector agent is the exception: the dashboard lets you change its limits but not revoke it, so disconnecting it in the app you connected from is what cuts off access.
Delivery details and phone
Your address and phone number live in Settings, and Sangria needs them at two different points:
- To search: your country and postal code. Your country sets your marketplace and currency, and the postal code is what lets Sangria show products, prices and delivery for your area.
- To buy: the full shipping address plus a phone number, which the merchant needs to complete the order.
Your country is set once and is fixed afterwards — contact support if you need to move accounts to another country.
Orders and transactions
Recent orders appear on your dashboard, and every credit movement — top-ups, purchases, refunds — is listed under Transactions. Your agents can list orders too: each one sees its own by default, and the CLI can list every order on the account with sangria orders --scope operator.
Currency and marketplace
Both follow your country. Sangria supports the United States and Singapore today, and your country decides two things: the Amazon marketplace your agents shop, and the currency your balance and limits are denominated in — USD or SGD. Your currency is reported alongside your balance.