# wines.bet Wine Price API

> wines.bet Wine Price API is a paid API for AI agents from api.wines.bet, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current market price, liquidity, and 30-day price trend for a specific wine by name, vintage, and country

## Facts

- Endpoint: GET https://api.wines.bet/v1/wine/price
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wines-bet-wine-price-api-6615dd66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8x93g3zdMHXfidSkjK1NQ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wines-bet-wine-price-api-6615dd66
```

Example prompt: What's the current market price, liquidity, and 30-day price trend for Sassicaia 2019 from Italy?

## When to prefer this

Use this endpoint when you need real-time market pricing, liquidity data, and short-term trend information for a specific wine. Prefer this over the sibling historical price series endpoint when you need current snapshot data rather than long-term analytics. Ideal for portfolio valuation, trade timing, and quick price checks on named wines with known vintages.

## Known failure modes

- Wine not found in database — returns empty or 404 if the name/vintage/country combination has no market data
- Missing required 'name' query parameter — returns validation error
- Invalid country code format — non-ISO 2-letter codes may return no results
- Invalid vintage year format — non-4-digit integers will fail validation
- Rate limit or payment failure via x402 protocol — returns 402 Payment Required

## How this service works

Real-time fine wine price oracle, valuation benchmark, market liquidity, and 30-day price trends for Italian and international fine wines and investment-grade vintages (Super Tuscans, Barolo, Brunello, Amarone).

## Output

Returns the current market price, available liquidity, and a 30-day price trend for the queried wine, scoped by wine name, vintage year, and optionally country. Response can be returned in English or Italian.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "lang": {
       "enum": [
        "en",
        "it"
       ],
       "type": "string",
       "description": "Response language (default: en)"
      },
      "name": {
       "type": "string",
       "description": "Wine name, producer, or denomination (e.g. Sassicaia, Barolo Monfortino, Tignanello, Ornellaia)"
      },
      "country": {
       "type": "string",
       "description": "2-letter ISO country code (e.g. IT, FR)"
      },
      "vintage": {
       "type": "integer",
       "description": "4-digit harvest vintage year (e.g. 2021)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "wine": {
    "id": "6645a1b2c3d4e5f6a7b8c9d0",
    "name": "Sassicaia",
    "vintage": 2021,
    "producer": "Tenuta San Guido",
    "countryCode": "IT"
   },
   "pricing": {
    "currency": "EUR",
    "trend30d": 2.96,
    "lastUpdated": "2026-09-11T00:00:00.000Z",
    "lowestPrice": 239.9,
    "offersCount": 38,
    "priceSpread": 49.1,
    "averagePrice": 257.4,
    "highestPrice": 289,
    "priceSpreadPct": 19.08
   }
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wines-bet-wine-price-api-6615dd66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wines.bet](https://www.zero.xyz/host/api.wines.bet/llms.txt)