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.

Workflows

Whole journeys, one real request at a time, each step filled in from the last.

Request builder
OAuth token

Production environment · Write requests require confirmation

Step by step over RESTAs a conversation with Crulio

Place a bid, with Crulio

Send the suggested messages in order, or say it your own way. Crulio picks the MCP tools — here, likely search_wines, list_bids, list_offers, place_bid, list_my_bids, cancel_bid — and each call appears in the conversation with what Cru returned.

CrulioCru World Wine’s assistant · on GPT-6 Astra

Ask in plain English. Crulio reads the market and the customer’s account through Cru’s MCP tools. What the tools return is shown as cards, and every call can be opened to see its arguments and result.

On production Crulio can prepare trades but not confirm them: each staged instruction gets a Confirm button here, behind the real-trade check.

Connect a customer account above first: Crulio uses its token to call Cru.

Enter to send · Shift + Enter for a new line

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).