Beta

The Partner Trading API v1 is in beta — endpoints and response shapes may still change.

Developers
 Cru World Wine

Configure connection

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.

How authentication works

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.

Partner credentials →

No credentials yet?

Credentials are kept for this session only, never included in copied examples, and redacted from everything the playground shows.

API playground

Build a request, over REST or MCP, and inspect the response.

Tool reference
Partner key

Production environment · Write requests require confirmation

Request

Prepares a change to the asking price or quantity of one listed line of the customer's portfolio (portfolio_id from list_my_listings, get_my_portfolio or the offer list_for_sale or an earlier change answered with), which changes that line's units only, or of a whole listing by its code. Documentation ↗

POSTtools/call · update_listing

https://us.cruworldwine.com/api/mcp

Carried out straight away, with no confirmation step. Sending the same reference again returns the first result, so each send gets a new one. You will be asked to confirm before it is sent.

Arguments

A listed line's portfolio_id, from list_my_listings, get_my_portfolio or an earlier offer result, to change only that line's units. Give this or code.

A listing's code, to change the whole listing. Give this or portfolio_id.

New price per unit, in the market currency, as pricing.listing_price quotes it. Omit to keep it.

New quantity. Omit to keep it.

Your own unique reference for this instruction.

Response

Nothing sent yet. The response appears here.

API credentials

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.

Request API access

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.

Markets you trade in (choose one or more)

We use what you send here to reply about API access, and for nothing else. Cloudflare Turnstile checks the form for bots (privacy policy).