Beta

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

Developers
 Cru World Wine
API v1 · Read access
Developer tools

Permission scopes

A credential receives a fixed set of scopes. An endpoint rejects a credential missing the required scope with A003 / 403.

SCOPECAPABILITYSTATUS
meta:readCheck the connection with /pingLive
market:readRead the Cru bid bookLive
bids:readRead your own bidsReserved
bids:writePlace and cancel your bidsReserved
offers:readRead your own offersReserved
offers:writeMake and cancel your offersReserved
orders:writeExecute against the bookReserved
trades:readRead your own tradesReserved
wines:readRead wine reference dataReserved
webhooks:manageManage webhook subscriptionsReserved
Reserved scopes do not enable planned endpoints

The scope names are declared in the reference, but the corresponding trading and webhook endpoints are still to be implemented.

Cru World Wine Developers · Partner Trading API v1
Based on the Cru Partner Trading API v1 reference, 14 September 2026.

API credentials

Enter the client key and secret issued by Cru. They are kept in memory until you reload or clear 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.