# Maple Syrup API
> Maple-syrup making maths as an API, computed locally and deterministically — the sap-to-syrup yield and finishing numbers a sugarmaker plans a season around. The yield endpoint takes the volume of sap and its sugar content in °Brix and returns the syrup it makes from the sugar balance (syrup = sap × sap °Brix / finished °Brix, finishing at 66.9 °Brix), the water that has to boil off, the sap-to-syrup ratio, and the classic Jones' Rule of 86 (86 ÷ sap °Brix) — the field rule that famously gives about 43 litres of 2 % sap per litre of syrup. The finish endpoint gives the boil-off finishing temperature: syrup is done about 4 °C (7.1 °F) above the boiling point of water, so at sea level that is ~104 °C / 219 °F — calibrate to your own water boiling point, which drops with altitude, and finish that many degrees higher; it also returns the finished density (~66.9 °Brix, SG ≈ 1.337). Everything is computed locally and deterministically, so it is instant and private. Ideal for maple-sugaring, homestead, craft-food and farm app developers, evaporator and yield-planning tools, and sugaring education. Pure local computation — no key, no third-party service, instant. Consistent volume units; temperatures in °C or °F. Live, nothing stored. 2 compute endpoints. A planning aid — a hydrometer or refractometer confirms the finish.

## 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/maple-api/..."
```

## Pricing
- **Free** (Free) — 6,950 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 65,500 calls/Mo, 6 req/s
- **Pro** ($8/Mo) — 258,000 calls/Mo, 15 req/s
- **Mega** ($27/Mo) — 1,470,000 calls/Mo, 40 req/s

## Endpoints

### Maple

#### `GET /v1/finish` — Finishing temperature

**Parameters:**
- `unit` (query, optional, string) — c or f (default c) Example: `c`
- `water_boiling` (query, optional, string) — Local water boiling point (default 100/212)
- `offset` (query, optional, string) — Degrees above water (default 4/7.1)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maple-api/v1/finish?unit=c"
```

#### `GET /v1/yield` — Sap → syrup yield

**Parameters:**
- `sap_volume` (query, required, string) — Sap volume Example: `100`
- `sap_brix` (query, required, string) — Sap sugar content °Brix Example: `2`
- `syrup_brix` (query, optional, string) — Finished °Brix (default 66.9)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maple-api/v1/yield?sap_volume=100&sap_brix=2"
```

### Meta

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

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


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