# Wines.bet Fine Wine Investment Analysis

> Wines.bet Fine Wine Investment Analysis is a paid API for AI agents from api.wines.bet, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-15).

Returns investment-grade wine market metrics including price index, financial returns across multiple timeframes, liquidity, volatility, Sharpe ratio, bid signals, price spread, and drinking maturity window for a named wine.

## Facts

- Endpoint: GET https://api.wines.bet/v1/wine/investment
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wines-bet-fine-wine-investment-analysis-e4f720f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PM5-znoy-nsXKa2ahwuAP

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-fine-wine-investment-analysis-e4f720f6
```

Example prompt: Pull me the full investment analysis for Sassicaia 2021 from Italy — I want to see the market index, 1-year returns, Sharpe ratio, bid signal, price spread, and the drinking maturity window.

## When to prefer this

Choose this endpoint when you need comprehensive investment-grade financial metrics for a specific fine wine — including multi-period returns, Sharpe ratio, liquidity, volatility, bid signals, and drinking maturity — rather than just a current spot price or general market overview. Ideal for portfolio management agents, RWA tokenization workflows, or collector decision-support tools that need structured financial data about a named wine and vintage.

## Known failure modes

- Wine name not found or unrecognized — returns empty or error response
- Invalid vintage year (non-integer or future year) — may return validation error
- Unsupported country code — query may return no results
- Rate limit or payment failure (x402) — HTTP 402 if USDC payment not processed
- Wine exists but insufficient market data — may return partial financials or null fields

## How this service works

Blue Chip & fine wine investment analysis oracle. Returns market index, financial returns (7d, 1m, 1y), liquidity level, volatility tier, Sharpe ratio, bid signals, price spread, and drinking maturity window for wine portfolio management and RWA tokenization.

## Output

A JSON object with a nested wine profile (name, producer, appellation, score, vintage, category) and a full investmentProfile block including: status label, drinking maturity window (drinkFrom/drinkUntil/currentMaturity), financials with 24h/7d/1m/1y price returns, currency, momentum, 90-day trend, bid signal tightness, liquidity rating, price floor, average price, current market index, price spread percentage, number of retailers tracked, volatility tier, Sharpe ratio, and a free-text analyst note.

## 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": "Investment-grade wine name or search term (e.g. Sassicaia, Masseto, Barolo Monfortino, Tignanello)"
      },
      "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",
    "score": 98,
    "status": "market_appreciation",
    "vintage": 2021,
    "category": "red",
    "producer": "Tenuta San Guido",
    "appellation": "Bolgheri Sassicaia DOC",
    "countryCode": "IT"
   },
   "investmentProfile": {
    "status": "market_appreciation",
    "maturity": {
     "drinkFrom": 2028,
     "drinkUntil": 2050,
     "currentMaturity": "young_cellaring"
    },
    "financials": {
     "asOf": "2026-09-11T00:00:00.000Z",
     "returns": {
      "change1m": 2.96,
      "change1y": 11.4,
      "change7d": 1.2,
      "change24h": 0.4
     },
     "currency": "EUR",
     "momentum": "positive",
     "trend90d": "bullish",
     "bidSignal": "tight",
     "liquidity": "high",
     "priceFloor": 239.9,
     "volatility": "low",
     "sharpeRatio": 1.85,
     "averagePrice": 257.4,
     "currentIndex": 142.5,
     "priceSpreadPct": 19.08,
     "retailersTracked": 38
    },
    "analystNote": "Iconic Super Tuscan with stellar global liquidity and consistent long-term appreciation."
   }
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wines-bet-fine-wine-investment-analysis-e4f720f6/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)