The Partner Trading API v1 is in beta — endpoints and response shapes may still change.
Choose how to authenticate your requests.
For Production · United States · USD — change these in the toolbar.
Use a credential without an IP allowlist: calls reach Cru from this site’s server.
Cru issues partners a CLIENT-KEY and CLIENT-SECRET, sent as headers on every request. There is no token to fetch first. Writes run at once and carry a reference the playground generates.
CLIENT-KEY
CLIENT-SECRET
reference
No credentials yet? Request API access
Credentials are kept for this session only, never included in copied examples, and redacted from everything the playground shows.
Build a request, over REST or MCP, and inspect the response.
Production environment · Write requests require confirmation
list_bids
Live bids on Cru World Wine: what buyers are offering to pay. Documentation ↗
tools/call · list_bids
https://us.cruworldwine.com/api/mcp
lwin18
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_price
Lowest price to include, in whole units of the market currency (12345 = £12,345).
max_price
Highest price to include, in whole units of the market currency.
depth
How many price levels to return per wine, best first. Omit for every level.
include_market_price
Add Cru's market price for each wine.
include_last_trade
Add the last traded price and date for each wine.
wine_name
Only wines whose name holds every word given, as search_wines matches, e.g. "Lafite 2010".
deliverable_warehouse
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_only
true: only bids that need stock that has already arrived. false: only bids that do not. Omit for both.
limit
Wines per page.
offset
Wines to skip, for the next page.
Nothing sent yet. The response appears here.
Enter the client key and secret issued by Cru. They are kept for this browser tab’s session — a reload keeps them, closing the tab or clearing them ends them.
Credentials are never included in copied examples, and are redacted from anything the console prints back.
Tell us who you are and what you want to build. Cru issues a client key and secret for your organisation, scoped to what you need.
We use what you send here to reply about API access, and for nothing else. Cloudflare Turnstile checks the form for bots (privacy policy).
