Wine pairing intelligence for developers. Sommelier-grade matching across 609 wine styles.
Three steps to your first wine pairing.
Create an account at developers.sommelierx.com and pick a plan (Starter €9/month, cancel monthly).
Generate a key from your dashboard. It works as soon as your plan is active.
Call the pairing endpoint with your key and get wine recommendations.
Get wine pairing recommendations in a single API call.
# Pair wines with a dish described in natural language curl -X POST https://api.sommelierx.com/api/v1/pairing/by-text \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{"text": "grilled salmon with asparagus"}'
The response includes ranked wine type recommendations with match scores, powered by a proprietary Wine DNA matching algorithm with 19 wine dimensions and 17 food dimensions.
Pass your key as a Bearer token in the Authorization header. Recommended for production use.
Create a key at developers.sommelierx.com. There is no free tier: keys without an active plan return 402 PLAN_REQUIRED.
No key, no plan, no intermediary. A priced request without a key returns 402 Payment Required with the exact requirements; sign a USDC transfer to the recipient with your own wallet as fee payer and retry with the PAYMENT-SIGNATURE header. Paid requests get PRO-tier access.
| Tier | Daily Limit | API Keys | Score Detail | Price |
|---|---|---|---|---|
| STARTER | 100 calls/day | 5 | Full pairing results | €9/mo |
| PRO | 30,000 calls/month included, then €0.02 per extra call | 10 | Full score breakdown + Wine DNA | €29/mo |
| ENTERPRISE | From 25,000 calls/day | 25 | Full access + SLA | On request |
Pro calls above the included 30,000 per month are invoiced at €0.02 per extra call. Manage your plan →
Every priced endpoint and MCP tool supports the x402 protocol (v2, scheme exact, network solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). Your agent signs a Solana transaction that transfers the price in USDC to the SommelierX wallet, pays its own network fee, and sends it base64-encoded in the PAYMENT-SIGNATURE header. SommelierX verifies and broadcasts the transaction itself — there is no facilitator in between — and returns the transaction signature in PAYMENT-RESPONSE. Prices start at $0.005 per request.
| Endpoint | Method | Description |
|---|---|---|
/pairing/calculate |
POST | Wine pairings from ingredient IDs |
/pairing/by-text |
POST | Natural language pairing |
/pairing/by-meal/{id} |
POST | Pairing for a specific meal |
/pairing/by-wine/{id}/meals |
GET | Reverse pairing: meals for a wine |
/search |
GET | Search meals and ingredients |
/ingredients |
GET | Browse all ingredients |
/meals |
GET | Browse all meals |
/wines/types |
GET | All wine types (MetaWines) |