{"uid":"cap_JAQ9DDYXf6pIWMLthkyhr","slug":"suverse-random-cocktail-a730756f","name":"Suverse Random Cocktail","description":"A random cocktail from TheCocktailDB, no key. Returns one drink with full ingredients and instructions. For AI agents suggesting drinks.","url":"https://proxy.suverse.io/v1/data/suverse-cocktail-random","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A4Myxkn2ILL2ZGve1wfH0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a single random cocktail from TheCocktailDB including full ingredient list and preparation instructions","exampleAgentPrompt":"Surprise me — pull a completely random cocktail recipe right now and tell me what's in it and how to make it.","exampleUseCases":[{"title":"Spontaneous drink night at home","prompt":"I have no idea what to make tonight — grab me a random cocktail recipe with the full ingredient list and instructions so I can see if I have everything."},{"title":"AI bartender suggestion feature","prompt":"My app needs to suggest a random drink to the user — fetch a random cocktail from TheCocktailDB with all the details like ingredients, measurements, and how to make it."},{"title":"Daily cocktail inspiration for newsletter","prompt":"Pull a random cocktail recipe for today's drink spotlight — I need the name, ingredients, and step-by-step instructions to share with readers."}],"resultDescription":"A single randomly selected cocktail object containing the drink name, category, glass type, thumbnail image URL, full ingredient list with measurements, and step-by-step preparation instructions as sourced from TheCocktailDB.","failureModes":["TheCocktailDB upstream unavailable — may return a 502 or timeout","Payment not fulfilled (x402 flow) — request rejected before proxying","Malformed POST body — returns validation error if required input fields are missing","Occasionally returns a non-alcoholic drink or obscure regional cocktail that may not match user expectations"],"whenToPreferThis":"Use this endpoint when you need a zero-configuration random cocktail suggestion without managing a TheCocktailDB API key. It's ideal for AI agents handling drink recommendations on the fly, daily inspiration features, or any scenario where a single random recipe with full details (ingredients, instructions, glassware) is sufficient and no filtering by ingredient or category is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:52:43.834Z","isFirstParty":false}