# Party & Event Planner

Food, drinks, ice, seating, timeline, bill split, pizza, cake and budget rule-of-thumb arithmetic for events.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://party-event-calc.x402tookit.com/openapi.json
- x402 manifest: https://party-event-calc.x402tookit.com/.well-known/x402
- Catalog (free): https://party-event-calc.x402tookit.com/catalog
- Health (free): https://party-event-calc.x402tookit.com/health
- Uptime (free): https://party-event-calc.x402tookit.com/uptime

## Endpoints (9)

### GET /bill-split — $0.02
Tip and even bill split in exact cents: tip on subtotal or total, shares that add up, optional round up to whole dollars.
Params: subtotal: number, people: number, tipPercent?: number, taxAmount?: number, tipOn?: string, roundUp?: string
Example: https://party-event-calc.x402tookit.com/bill-split?subtotal=87.5&taxAmount=7&tipPercent=18&people=4

### GET /budget-split — $0.02
Split an event budget by percent into exact-cent amounts that add up to the total (largest-remainder rounding).
Params: totalBudget: number, categories?: string
Example: https://party-event-calc.x402tookit.com/budget-split?totalBudget=5000&categories=Venue%3A30%2CFood%3A35%2CEntertainment%3A10%2CDecor%3A10%2COther%3A5%2CContingency%3A10

### GET /cake-servings — $0.02
Cake servings from pan size and area per slice: round, square or rectangle, one or several tiers, wedding or party slice style.
Params: shape: string, sizeIn: string, widthIn?: number, sliceStyle?: string, servingSqIn?: number
Example: https://party-event-calc.x402tookit.com/cake-servings?shape=round&sizeIn=6%2C8%2C10&sliceStyle=wedding

### GET /drinks-estimate — $0.02
Drinks for an event from a first-hour and later-hours rule per guest, split into beer, wine and liquor, with bottle counts.
Params: guests: number, hours: number, firstHourDrinks?: number, laterHourDrinks?: number, nonDrinkingPercent?: number, beerPercent?: number, winePercent?: number, liquorPercent?: number, drinksPerWineBottle?: number, drinksPerLiquorBottle?: number
Example: https://party-event-calc.x402tookit.com/drinks-estimate?guests=50&hours=4

### GET /event-timeline — $0.02
Backwards timeline from the event start: milestones given as minutes before start become 12-hour clock times, earliest first.
Params: eventStart: string, milestones?: string
Example: https://party-event-calc.x402tookit.com/event-timeline?eventStart=6%3A00+PM&milestones=Venue+access%3A240%2CDecor+done%3A120%2CCaterer+arrives%3A90%2CSound+check%3A60%2CDoors+open%3A30

### GET /food-quantity — $0.02
Food to prepare for a guest count by course (appetizer, main, side, salad, dessert, bread) with kid and appetite multipliers.
Params: guests: number, type: string, kids?: number, kidFactor?: number, multiplier?: number, perGuest?: number
Example: https://party-event-calc.x402tookit.com/food-quantity?guests=40&type=main-boneless&kids=10

### GET /ice-estimate — $0.02
Pounds and bags of ice for a guest count from a per-guest rule, with hot-weather multiplier and extra for chilling drinks.
Params: guests: number, lbPerGuest?: number, hotWeatherMultiplier?: number, extraPounds?: number, bagPounds?: number
Example: https://party-event-calc.x402tookit.com/ice-estimate?guests=40

### GET /pizza-order — $0.02
How many pizzas to order from guests, kids and slices each, with pizza area, area per guest and a size comparison.
Params: guests: number, kids?: number, slicesPerAdult?: number, slicesPerChild?: number, diameterIn?: number, slicesPerPizza?: number, extraPercent?: number, compareDiameterIn?: number, pricePerPizza?: number
Example: https://party-event-calc.x402tookit.com/pizza-order?guests=30&kids=10

### GET /tables-chairs — $0.02
Tables and chairs for a guest count from seats per table, with spare chairs, empty seats and tables for food, cake or gifts.
Params: guests: number, seatsPerTable?: number, spareChairPercent?: number, extraTables?: number
Example: https://party-event-calc.x402tookit.com/tables-chairs?guests=75&seatsPerTable=8

## Terms

Rule-of-thumb event planning arithmetic, provided as is. Default portions, serving sizes and drink counts are common caterer-style estimates that vary by crowd, menu, weather and culture; every one is an input you can change. Order extra for important events. Not food-safety, alcohol-service, venue-capacity, fire-code, tax or legal advice.