{"uid":"cap_PM5-znoy-nsXKa2ahwuAP","slug":"wines-bet-fine-wine-investment-analysis-e4f720f6","name":"Wines.bet Fine Wine Investment Analysis","description":"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.","url":"https://api.wines.bet/v1/wine/investment","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N2ncfGZ2qjL9CtKxqArjy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"RWA tokenization due diligence","prompt":"I'm tokenizing a fine wine portfolio and need the investment profile for Masseto 2019 from Italy — give me the market index, liquidity level, volatility tier, Sharpe ratio, and price floor so I can set the token valuation."},{"title":"Wine portfolio rebalancing decision","prompt":"Compare the 1-month and 1-year returns, bid signal, and price spread for Barolo Monfortino — I want to know if it's still appreciating or if I should sell my allocation."},{"title":"Collector cellar maturity check","prompt":"I have Tignanello 2021 in my cellar — is it ready to drink yet or still young for cellaring? Also tell me the current market index and whether it's gaining value so I know if I should hold or sell."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:34.927Z","isFirstParty":false}