{"openapi":"3.1.0","info":{"title":"Grain Bin API","version":"1.0.0","description":"Grain-bin storage maths as an API, computed locally and deterministically — the bushel and weight numbers a farmer or elevator sizes storage by. The bushels endpoint measures a round bin: floor area × grain depth gives the cubic feet, and a cubic foot holds about 0.8036 bushels, so an 18-foot bin filled 20 feet level holds roughly 4,090 bushels — and grain heaped to a peak adds a cone of (1/3) × floor area × peak height, so a 4-foot peak adds about 270 more. The weight endpoint converts bushels to weight by the crop’s standard test weight — corn and sorghum at 56 pounds a bushel, wheat and soybeans 60, oats 32, barley 48 — so those 4,090 bushels of corn weigh 229,040 pounds, about 114.5 US tons or 104 tonnes; pass a measured test weight for light or heavy grain. Everything is computed locally and deterministically, so it is instant and private. Ideal for agriculture, grain-elevator, farm-management and ag-tech app developers, storage-capacity and inventory tools, and harvest software. Pure local computation — no key, no third-party service, instant. US units (feet, bushels, pounds). Live, nothing stored. 2 compute endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/grainbin-api","description":"oanor gateway"}],"tags":[{"name":"GrainBin"},{"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/bushels":{"get":{"operationId":"get_v1_bushels","tags":["GrainBin"],"summary":"Bushels in a round bin","description":"","parameters":[{"name":"diameter_ft","in":"query","required":true,"description":"Bin diameter (ft)","schema":{"type":"string"},"example":"18"},{"name":"fill_height_ft","in":"query","required":true,"description":"Level grain depth (ft)","schema":{"type":"string"},"example":"20"},{"name":"peak_height_ft","in":"query","required":false,"description":"Cone peak height above level (ft)","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A round bin holds floor area × grain depth in cubic feet, and 1 ft³ ≈ 0.8036 bushels. Grain heaped to a peak adds a cone: (1/3) × floor area × peak height. An 18-ft bin filled 20 ft level holds about 4,090 bushels.","inputs":{"diameter_ft":18,"fill_height_ft":20,"peak_height_ft":0},"peak_bushels":0,"level_bushels":4090,"total_bushels":4090,"floor_area_sqft":254.5,"total_cubic_feet":5089.4},"meta":{"timestamp":"2026-06-06T15:30:50.135Z","request_id":"d035f950-c13b-42a4-8b22-ad059aa3bb3d"},"status":"ok","message":"Bin bushels","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/weight":{"get":{"operationId":"get_v1_weight","tags":["GrainBin"],"summary":"Grain weight from bushels","description":"","parameters":[{"name":"bushels","in":"query","required":true,"description":"Number of bushels","schema":{"type":"string"},"example":"4090"},{"name":"crop","in":"query","required":false,"description":"corn, wheat, soybeans, oats, barley, …","schema":{"type":"string"},"example":"corn"},{"name":"test_weight_lb","in":"query","required":false,"description":"Measured test weight (lb/bu)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Weight = bushels × the crop's standard test weight (corn & sorghum 56 lb/bu, wheat/soybeans 60, oats 32, barley 48). Test weight is a quality measure too — light grain weighs less per bushel than the standard.","inputs":{"crop":"corn","bushels":4090,"test_weight_lb":56},"total_pounds":229040,"total_us_tons":114.52,"total_metric_tonnes":103.89,"test_weight_lb_per_bu":56},"meta":{"timestamp":"2026-06-06T15:30:50.232Z","request_id":"4303719a-8e92-40d4-9916-f4a5370096ea"},"status":"ok","message":"Grain weight","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":"Round bins: bushels = (π/4·d²·depth) × 0.8036; peak adds (1/3)·area·peak. Test weights: corn 56, wheat/soy 60, oats 32, barley 48 lb/bu. Feet and bushels. For grain-drying or aeration use a different tool.","service":"grainbin-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/weight":"Grain weight (lb / tons / tonnes) from bushels by crop test weight.","GET /v1/bushels":"Bushels in a round bin from diameter, fill height and an optional peak."},"description":"Grain-bin storage maths: bushels in a round bin (level fill plus cone peak), and grain weight from bushels by crop."},"meta":{"timestamp":"2026-06-06T15:30:50.327Z","request_id":"913c0e54-3e55-44c0-bfea-62a5d6847826"},"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":6380,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":441,"monthly_call_quota":53100,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1214,"monthly_call_quota":223000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3875,"monthly_call_quota":1303000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/grainbin-api"}