# Screw Auger API
> Screw-conveyor and grain-auger maths as an API, computed locally and deterministically — the capacity, speed and throughput numbers a farmer, millwright or material-handling engineer sizes an auger with. The capacity endpoint gives the volumetric throughput from the screw geometry: the annular flight volume per turn ((π/4)(diameter² − shaft²) × pitch) × rpm × 60 × the trough loading, so a 9-inch full-pitch screw on a 2.5-inch shaft at 40 rpm and 45 % loading moves about 330 cubic feet — 265 bushels — an hour. The speed endpoint inverts it, the rpm needed for a target capacity, so you don't overspeed a small auger and grind the grain. The bushels endpoint converts a volumetric rate to bushels and tons per hour (1 bushel = 1.2445 ft³, tons = bushels × test weight ÷ 2000), so 330 ft³/hr of 56-lb corn is 265 bushels or 7.4 tons an hour — the number you match to the dryer or the truck. Everything is computed locally and deterministically, so it is instant and private. Ideal for grain-handling and ag-equipment apps, material-handling and conveyor-design tools, farm-build calculators, and engineering aids. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Estimates — incline and material change real throughput. For belt conveyors use a conveyor API.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/auger-api/..."
```

## Pricing
- **Free** (Free) — 440 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 11,600 calls/Mo, 6 req/s
- **Pro** ($17/Mo) — 77,000 calls/Mo, 15 req/s
- **Mega** ($51/Mo) — 254,000 calls/Mo, 36 req/s

## Endpoints

### Auger

#### `GET /v1/bushels` — ft³/hr to bushels and tons

**Parameters:**
- `ft3_hr` (query, required, string) — Volumetric rate in ft³/hr Example: `330`
- `test_weight_lb_bu` (query, optional, string) — Test weight in lb/bushel (default 56) Example: `56`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/auger-api/v1/bushels?ft3_hr=330&test_weight_lb_bu=56"
```

#### `GET /v1/capacity` — Volumetric capacity

**Parameters:**
- `diameter_in` (query, required, string) — Screw diameter in inches Example: `9`
- `rpm` (query, required, string) — Screw speed in rpm Example: `40`
- `shaft_diameter_in` (query, optional, string) — Center shaft diameter in inches (default ≈0.28D) Example: `2.5`
- `pitch_in` (query, optional, string) — Flight pitch in inches (default = diameter) Example: `9`
- `loading_pct` (query, optional, string) — Trough loading % (default 45) Example: `45`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/auger-api/v1/capacity?diameter_in=9&rpm=40&shaft_diameter_in=2.5&pitch_in=9&loading_pct=45"
```

#### `GET /v1/speed` — Speed for a target capacity

**Parameters:**
- `diameter_in` (query, required, string) — Screw diameter in inches Example: `9`
- `target_ft3_hr` (query, required, string) — Target capacity in ft³/hr Example: `330`
- `shaft_diameter_in` (query, optional, string) — Center shaft diameter in inches Example: `2.5`
- `pitch_in` (query, optional, string) — Flight pitch in inches (default = diameter) Example: `9`
- `loading_pct` (query, optional, string) — Trough loading % (default 45) Example: `45`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/auger-api/v1/speed?diameter_in=9&target_ft3_hr=330&shaft_diameter_in=2.5&pitch_in=9&loading_pct=45"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/auger-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/auger-api
OpenAPI spec: https://www.oanor.com/api/auger-api/openapi.json