Your bids
The customer's own bids to buy wine, newest first: the price they offered per unit (before Cru's commission, in the market currency - a bid placed in another currency, which bid_currency names, is converted at today's rate), quantity, how much has matched, order_numbers - the Cru orders it matched into - with order_urls, their pages on Cru, status (live; matched - awaiting invoice; complete; cancelled; expired), expiry date, and renewable - whether renew_bid takes the bid now (the customer's allowance is checked when renewing). Only live bids unless status names others. code identifies a bid for update_bid, renew_bid and cancel_bid; client_ref is the customer's own reference, when they gave one. Prices are normal amounts in the market currency - 12345.5 is 12,345.50 - and every market states its currency.
Marked readOnlyHint, so an assistant may call it without asking the customer first.
Arguments
ALL OPTIONAL| ARGUMENT | DESCRIPTION |
|---|---|
| statusarray<string> · one of live, matched, complete, cancelled, expired, error · ≤ 6 | Only bids in these states, e.g. ["matched", "complete"]. Omit for live bids only. Default: live |
| lwin18array<string> · LWIN18 · ≤ 20 | Only bids on these wines, as 18-digit LWIN18 codes (wine, vintage and pack). Get them from search_wines. |
| client_refstring | Only bids with this client_ref. |
| limitinteger · 1–50 | Bids per page. Default: 10 |
| offsetinteger · 0–10000 | Bids to skip, for the next page. Default: 0 |
Any other argument is refused with a tool error that lists what the tool accepts. Numbers may also be sent as strings, and booleans as "true" or 1.
Returns
STRUCTUREDCONTENTbids: code, client_ref, wine, product_url, gross price and currency (the market’s), bid_currency, quantity, quantity_matched, quantity_open, order_numbers, order_urls, status, renewable, market, expiry; pagination.
The same object also comes as JSON text in content, for hosts that read only that.
Errors
A refusal — a wine that is not on Cru, a price out of range — comes back as a result with isError: true and a message worded for the assistant to act on. A connection without bids:read is not offered this tool, and calling it anyway returns 403 with a JSON-RPC error naming the scope. Missing or invalid credentials return 401. Conventions every tool shares →