Sommelier & terroir intelligence API
Sommelier & terroir intelligence API. Integrates wine vintage, grape varieties (with sensory radar for tannins, acidity, body, aromatic intensity), winery heritage, geographical appellations (DOCG/DOC), and tailored serving and decanting guidance.
by api.wines.bet · discovered, not yet claimed by its owner · updated 2026-09-12
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Sommelier & terroir intelligence API. Integrates wine vintage, grape varieties (with sensory radar for tannins, acidity, body, aromatic intensity), winery heritage, geographical appellations (DOCG/DOC), and tailored serving and decanting guidance.
Tags: bazaar
Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/8195.jsonfor the price and payment options. - Pay. Call
GET https://api.wines.bet/v1/wine/sommelier. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.01 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base
- Uptime
- 1 of the last 1 checks answered
- Calls (30d)
- 1 · 1 unique payers (third-party data from the public x402 Bazaar)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.01 | 0x350A947254e59291FAB58430E03A86589E0D8bA8 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x350A947254e59291FAB58430E03A86589E0D8bA8",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"country": "IT",
"lang": "en",
"name": "Barolo",
"vintage": 2019
},
"type": "http"
},
"output": {
"example": {
"data": {
"grapes": [
{
"color": "red",
"name": "Nebbiolo",
"profile": "High tannin, high acidity, ruby-garnet color with floral and spiced aromatics.",
"sensoryProfile": {
"acidity": 4,
"aromaticIntensity": 4,
"body": 4,
"elegance": 5,
"longevity": 5,
"tannin": 5
},
"slug": "nebbiolo"
}
],
"producer": {
"annualBottles": 250000,
"description": "Historic family-owned Barolo pioneer renowned for single-vineyard crus.",
"founded": 1873,
"hectares": 35,
"location": "Castiglione Falletto (CN)",
"name": "Vietti",
"region": "Piedmont",
"slug": "vietti"
},
"sommelierNotes": {
"characteristicsSummary": "Classic expression of Piedmont, crafted with Nebbiolo. Balanced sensory profile combining varietal typicity and terroir distinction.",
"drinkingWindow": {
"currentMaturity": "in_drinking_window",
"drinkFrom": 2025,
"drinkUntil": 2045
},
"servingAdvice": "Optimal serving temperature: 16-18°C. Serve in a large Bordeaux/Burgundy glass. At optimal drinking peak: uncork 30-45 minutes before serving."
},
"terroir": {
"country": "IT",
"denomination": "Barolo DOCG",
"province": "CN",
"region": "Piedmont"
},
"wine": {
"appellation": "Barolo DOCG",
"category": "red",
"description": "Elegantly structured red with notes of dried rose, tar, and wild berries.",
"id": "6645a1b2c3d4e5f6a7b8c9d1",
"name": "Barolo",
"vintage": 2019
}
},
"success": true
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"country": {
"description": "2-letter ISO country code (e.g. IT, FR)",
"type": "string"
},
"lang": {
"description": "Response language (default: en)",
"enum": [
"en",
"it"
],
"type": "string"
},
"name": {
"description": "Wine name, grape variety, or denomination (e.g. Barolo, Brunello di Montalcino, Amarone)",
"type": "string"
},
"vintage": {
"description": "4-digit harvest vintage year (e.g. 2019)",
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Example shape — generated from the schema, not a captured live response
nullExamples
curl "https://api.wines.bet/v1/wine/sommelier"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://api.wines.bet/v1/wine/sommelier");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://api.wines.bet/v1/wine/sommelier")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- api.wines.bet
- Endpoint
- https://api.wines.bet/v1/wine/sommelier
- Machine-readable
/resources/8195.json