#alcohol

Alcohol and cocktail maths as an API, computed locally and deterministically — the ABV, dilution and standard-drink numbers a bartender, brewer or drinks app works out behind the bar. The abv endpoint mixes a drink: pass the ingredients as a volume:abv list and it returns the final alcohol by volume = (sum of volume × ABV) ÷ total volume, so a Negroni-style 2 parts at 40 %, 1 at 20 % and 1 mixer at 0 % lands at 25 % ABV (50 US proof), with mixers diluting the result. The dilution endpoint models ice melt and stirring, which add water and drop the strength: final volume = volume × (1 + dilution) and ABV falls by the same factor while the alcohol itself is unchanged, so a 4 oz stirred drink at 25 % with 25 % dilution becomes 5 oz at 20 % — stirred drinks pick up roughly 20–25 %, shaken a little more. The standard endpoint counts the dose: pure alcohol = volume × ABV, then a US standard drink is 14 grams (0.6 fl oz) and a UK unit is 10 ml of pure alcohol, so a 12 fl oz beer at 5 % is one standard drink (14 g, 1.77 UK units) and a 5 fl oz glass of 12 % wine is one too. Everything is computed locally and deterministically, so it is instant and private. Ideal for bartending, brewing, beverage, hospitality and responsible-drinking app developers, cocktail-builder and drink-tracker tools, and bar-menu calculators. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. For drink recipes use a cocktails database API.

api.oanor.com/abv-api

Blood-alcohol estimation as an API, using the Widmark equation, computed locally and deterministically. The estimate endpoint works out the peak and current blood-alcohol concentration — in both per mille (‰) and percent (%) — from the alcohol consumed, body weight, sex and the time elapsed since drinking, and tells you roughly how long until you are sober or back under a chosen legal limit. Alcohol can be given as grams, as US standard drinks, or as a drink volume and ABV. The drink endpoint is a standard-drink calculator: from a volume and ABV it returns the grams of pure alcohol, US standard drinks (14 g), UK units (10 ml) and EU standard drinks (10 g). The sober endpoint estimates the time for a current BAC to fall to zero or to a target limit at a chosen elimination rate. Everything is computed locally and deterministically, so it is instant and private. IMPORTANT: this is a rough estimate for educational use only — real blood-alcohol depends on many personal and situational factors. Never use it to decide whether it is safe or legal to drive; when in doubt, do not drive. Ideal for educational and harm-reduction tools, hospitality and event apps, and personal drink trackers. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is blood-alcohol maths; for the calories or nutrition of drinks use a food or nutrition API.

api.oanor.com/bac-api