{"openapi":"3.1.0","info":{"title":"Pottery & Ceramics API","version":"1.0.0","description":"Pottery and ceramics maths as an API, computed locally and deterministically — the shrinkage, glaze-batch and firing numbers a potter works out at the wheel and the kiln. The shrinkage endpoint handles the fact that clay shrinks from wet to bone-dry to fired: with a typical 12 % linear shrinkage a 100 mm rim fires down to 88 mm, and run in reverse it tells you to throw a piece larger to land on a target size — make it 100 mm wet to finish at 88 mm — and reports the volume shrinkage, which is the cube of the linear factor (about 32 %). The glaze endpoint scales a percentage recipe to a real batch: pass the ingredients as a name:percent list and a dry batch weight and it returns the grams of each, dividing by the recipe’s own percent sum so recipes that total over 100 % (a base 100 plus colorant and opacifier additions) still scale correctly, plus the water to add for dipping. The cone endpoint gives the approximate firing temperature for an Orton self-supporting cone at the standard 108 °F/hour ramp — cone 06 is about 1828 °F (998 °C) for bisque, cone 6 about 2232 °F (1222 °C) and cone 10 about 2345 °F (1285 °C) for stoneware — and reminds you that a cone measures heat-work, not just temperature. Everything is computed locally and deterministically, so it is instant and private. Ideal for ceramics, pottery-studio, maker and craft app developers, kiln-log and glaze-calculator tools, and studio-management software. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. For kiln-element power use a different API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pottery-api","description":"oanor gateway"}],"tags":[{"name":"Pottery"},{"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/cone":{"get":{"operationId":"get_v1_cone","tags":["Pottery"],"summary":"Cone firing temperature","description":"","parameters":[{"name":"cone","in":"query","required":true,"description":"Orton cone number, e.g. '06', '6', '10'","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Orton self-supporting large-cone temperatures at the standard 108 °F/hr final ramp. Cone is a measure of heat-work (time × temperature), not just temperature — a slower ramp matures at a lower reading. Bisque is often 06–04; stoneware glaze 6 or 10.","ramp":"108 °F/hr (self-supporting large cone)","range":"mid-to-high fire","inputs":{"cone":"6"},"temperature_c":1222,"temperature_f":2232},"meta":{"timestamp":"2026-06-06T07:14:05.358Z","request_id":"5022107e-60dd-4ce2-b841-8bf8780279c4"},"status":"ok","message":"Cone temperature","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/glaze":{"get":{"operationId":"get_v1_glaze","tags":["Pottery"],"summary":"Glaze batch","description":"","parameters":[{"name":"recipe","in":"query","required":true,"description":"Comma list of 'name:percent'","schema":{"type":"string"},"example":"Custer Feldspar:40,Silica:25,Whiting:20,Kaolin:15"},{"name":"batch_grams","in":"query","required":false,"description":"Dry batch weight (default 1000)","schema":{"type":"string"},"example":"1000"},{"name":"water_percent","in":"query","required":false,"description":"Water as % of dry weight","schema":{"type":"string"},"example":"85"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Each ingredient's grams = (its percent ÷ the recipe's percent sum) × batch weight, so recipes that total over 100 % (base 100 + colorant/opacifier additions) still scale correctly. Add water to taste for dipping (often ~80–90 % of dry weight, ~1.4–1.5 specific gravity).","inputs":{"batch_grams":1000,"water_percent":85,"recipe_percent_sum":100},"ingredients":[{"name":"Custer Feldspar","grams":400,"percent":40},{"name":"Silica","grams":250,"percent":25},{"name":"Whiting","grams":200,"percent":20},{"name":"Kaolin","grams":150,"percent":15}],"water_grams":850,"dry_total_grams":1000},"meta":{"timestamp":"2026-06-06T07:14:05.459Z","request_id":"0104d60f-3ad2-47d9-bdb0-251ba1973b49"},"status":"ok","message":"Glaze batch","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/shrinkage":{"get":{"operationId":"get_v1_shrinkage","tags":["Pottery"],"summary":"Clay shrinkage","description":"","parameters":[{"name":"size","in":"query","required":true,"description":"Size to convert","schema":{"type":"string"},"example":"100"},{"name":"shrinkage_percent","in":"query","required":false,"description":"Linear shrinkage % (default 12)","schema":{"type":"string"},"example":"12"},{"name":"direction","in":"query","required":false,"description":"forward (wet→fired) or reverse","schema":{"type":"string"},"example":"forward"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Linear shrinkage applies wet → bone-dry → fired: fired = wet × (1 − shrinkage). To end at a target size, throw it larger: wet = target ÷ (1 − shrinkage). Most clay bodies shrink 10–13 % linear; volume shrinks by the cube of that.","inputs":{"size":100,"direction":"forward","shrinkage_percent":12},"wet_size":100,"fired_size":88,"linear_shrink_factor":0.88,"total_volume_shrink_percent":31.85},"meta":{"timestamp":"2026-06-06T07:14:05.549Z","request_id":"42d12d6c-5b7c-44d0-9e30-b2c8845643f3"},"status":"ok","message":"Clay shrinkage","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":"Shrinkage is linear (volume = the cube). Glaze ingredients pass as 'name:percent' comma list and scale by the recipe's own percent sum. Cone temps are Orton self-supporting large cones at 108 °F/hr. For kiln-element power use a different API.","service":"pottery-api","endpoints":{"GET /v1/cone":"Approximate firing temperature for an Orton cone number.","GET /v1/meta":"This document.","GET /v1/glaze":"Scale a percentage glaze recipe to a dry batch weight, plus water.","GET /v1/shrinkage":"Wet ↔ fired size for a clay shrinkage percentage (forward or reverse)."},"description":"Pottery / ceramics maths: clay shrinkage (wet ↔ fired), glaze batch scaling from a percentage recipe, and Orton cone firing temperatures."},"meta":{"timestamp":"2026-06-06T07:14:05.633Z","request_id":"5991499c-4341-4b56-b502-958b7ef9276e"},"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":7250,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":410,"monthly_call_quota":57500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1145,"monthly_call_quota":235500,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3620,"monthly_call_quota":1355000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pottery-api"}