{"openapi":"3.1.0","info":{"title":"Candle Making API","version":"1.0.0","description":"Candle-making maths as an API, computed locally and deterministically — the wax, fragrance and burn-time numbers a chandler scales a batch with. The recipe endpoint sizes a pour from the container water volume: wax (g) per candle = volume(ml) × fill% × wax density (soy ≈ 0.9, beeswax ≈ 0.96, paraffin ≈ 0.9 g/ml), so a 250 ml jar at 80 % fill takes 180 g of soy wax; it adds the fragrance oil at the load percentage (commonly 6–10 %, never above the wax's maximum) and multiplies everything by the number of candles for the total wax, total fragrance and batch weight. The burn endpoint estimates how long a candle lasts: burn time ≈ wax grams ÷ burn rate, where a typical container candle consumes about 7–9 g of wax an hour. Everything is computed locally and deterministically, so it is instant and private. Ideal for candle-making, home-fragrance, handmade-craft and maker app developers, batch-calculator and recipe tools, and chandlery education. Pure local computation — no key, no third-party service, instant. Metric: millilitres, grams, percent. Live, nothing stored. 2 compute endpoints. A planning aid — pour tests and your wax datasheet always win.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/candle-api","description":"oanor gateway"}],"tags":[{"name":"Candle"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/burn":{"get":{"operationId":"get_v1_burn","tags":["Candle"],"summary":"Burn-time estimate","description":"","parameters":[{"name":"wax_grams","in":"query","required":true,"description":"Wax weight (g)","schema":{"type":"string"},"example":"180"},{"name":"burn_rate","in":"query","required":false,"description":"Burn rate g/hour (default 8)","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Burn time ≈ wax grams ÷ burn rate. A typical container candle burns ~7–9 g of wax per hour; bigger wicks burn faster. Measure your own rate for accuracy.","inputs":{"burn_rate":8,"wax_grams":180},"burn_time_hours":22.5,"burn_time_formatted":"22h 30m"},"meta":{"timestamp":"2026-06-06T07:14:11.965Z","request_id":"30089111-a333-484d-942a-bb018009bcf9"},"status":"ok","message":"Burn time","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/recipe":{"get":{"operationId":"get_v1_recipe","tags":["Candle"],"summary":"Wax & fragrance for containers","description":"","parameters":[{"name":"container_volume","in":"query","required":true,"description":"Container water volume (ml)","schema":{"type":"string"},"example":"250"},{"name":"count","in":"query","required":false,"description":"Number of candles (default 1)","schema":{"type":"string"},"example":"4"},{"name":"fill_percent","in":"query","required":false,"description":"Fill % (default 80)","schema":{"type":"string"},"example":"80"},{"name":"wax_type","in":"query","required":false,"description":"soy, paraffin, beeswax, coconut, palm","schema":{"type":"string"},"example":"soy"},{"name":"wax_density","in":"query","required":false,"description":"Override density (g/ml)","schema":{"type":"string"}},{"name":"fragrance_percent","in":"query","required":false,"description":"Fragrance load % (default 8)","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Wax (g) per candle = container volume(ml) × fill% × wax density (soy ≈ 0.9 g/ml). Fragrance = wax × load% (commonly 6–10%, never above the wax's max). Multiply by the number of candles.","inputs":{"count":4,"wax_type":"soy","fill_percent":80,"container_volume":250,"fragrance_percent":8},"wax_density":0.9,"total_wax_grams":720,"batch_weight_grams":777.6,"wax_per_candle_grams":180,"total_fragrance_grams":57.6,"fragrance_per_candle_grams":14.4},"meta":{"timestamp":"2026-06-06T07:14:12.069Z","request_id":"b2f9a3c9-1180-45c3-b29b-d7e9d6152d79"},"status":"ok","message":"Wax & fragrance","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Metric: millilitres (container water volume), grams, percent. Wax density defaults by type (soy 0.9, beeswax 0.96…). A planning aid — pour tests and your wax's datasheet always win.","service":"candle-api","endpoints":{"GET /v1/burn":"Estimated burn time from wax weight and a burn rate.","GET /v1/meta":"This document.","GET /v1/recipe":"Wax and fragrance grams for N containers from volume, fill %, wax type and fragrance load."},"description":"Candle-making maths: wax and fragrance for a set of containers, and burn-time estimation."},"meta":{"timestamp":"2026-06-06T07:14:12.174Z","request_id":"552380a5-57ca-4659-87ce-aa12125b7a2b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":330,"monthly_call_quota":61000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":920,"monthly_call_quota":246000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2950,"monthly_call_quota":1410000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/candle-api"}