Bids: what you could sell for
Live bids on Cru World Wine: what buyers are offering to pay. Use this to answer "what could I sell this wine for". Each bid price is NET of Cru's commission, so it is what the seller would receive. Results are grouped by wine (LWIN18). Cru's own bids come first, newest first, then other bids, highest first - for the wines on a page and for the bids within a wine - so a small depth may leave out the highest bid. is_own_bid marks the customer's own bids, which they cannot fill. requirements says what a seller must satisfy to fill a bid: condition_status (always verified - only verified stock can be sold into a bid), landed stock, and deliverable_warehouses, the warehouse codes stock must be in. 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 |
|---|---|
| lwin18array<string> · LWIN18 · ≤ 20 | Only these wines, as 18-digit LWIN18 codes (wine, vintage and pack). Get them from search_wines. Omit to page through the whole book. |
| min_priceinteger · ≥ 0 | Lowest price to include, in whole units of the market currency (12345 = £12,345). |
| max_priceinteger · ≥ 0 | Highest price to include, in whole units of the market currency. |
| depthinteger · ≥ 1 | How many price levels to return per wine, best first. Omit for every level. |
| include_market_priceboolean | Add Cru's market price for each wine. Default: false |
| include_last_tradeboolean | Add the last traded price and date for each wine. Default: false |
| wine_namestring · ≤ 100 chars | Only wines whose name holds every word given, as search_wines matches, e.g. "Lafite 2010". |
| deliverable_warehousearray<string> · one of UK_DRAK, HK_KERRY, SG_TOLL, FR_DARTESS, US_NAPA · ≤ 5 | Only bids that stock in any of these Cru warehouses can fill - see list_warehouses, or a line's warehouse.deliverable_warehouse_code in get_my_portfolio. |
| landed_stock_onlyboolean | true: only bids that need stock that has already arrived. false: only bids that do not. Omit for both. |
| limitinteger · 1–50 | Wines per page. Default: 10 |
| offsetinteger · 0–10000 | Wines 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
STRUCTUREDCONTENTmarkets, each with the wine and its bids (code, net price, quantity, is_own_bid, expires_at, updated_at, requirements), and 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 market: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 →