> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Data

> Commodity prices, USDA transport data, and seasonal anomalies — endpoints for grain, oilseed, and bulk freight market signals tied to Overwatch port events.

Commodity prices, USDA transport data, and seasonal anomalies.

## `GET` `/api/v1/commodity-prices`

IMF commodity benchmark prices, sourced via the [FRED](https://fred.stlouisfed.org/) API. Series cover wheat, corn, soybeans, crude oil (Brent and WTI), coal, US natural gas, and iron ore. Refreshed weekly on Monday at 06:00 UTC.

**Parameters**

| Name        | Type   | Required | Description                                    |
| ----------- | ------ | -------- | ---------------------------------------------- |
| `commodity` | string |          | e.g. 'wheat', 'crude\_oil\_brent', 'iron\_ore' |
| `since`     | string |          | ISO date                                       |
| `limit`     | number |          | Default 100, max 500                           |

**Response**

```json theme={null}
{ "commodity_prices": [...] }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/commodity-prices?commodity=VALUE&since=VALUE
```

## `GET` `/api/v1/transport-data`

USDA Grain Transportation Report data: barge, rail, and truck volumes.

**Parameters**

| Name        | Type   | Required | Description                  |
| ----------- | ------ | -------- | ---------------------------- |
| `mode`      | string |          | 'barge' \| 'rail' \| 'truck' |
| `commodity` | string |          | Commodity filter             |
| `region`    | string |          | Origin region (fuzzy match)  |
| `since`     | string |          | ISO date                     |
| `limit`     | number |          | Default 100, max 500         |

**Response**

```json theme={null}
{ "transport_data": [...] }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/transport-data?mode=VALUE&commodity=VALUE
```

## `GET` `/api/v1/anomalies`

Seasonal and trailing anomalies in export volumes.

**Parameters**

| Name       | Type   | Required | Description                                                 |
| ---------- | ------ | -------- | ----------------------------------------------------------- |
| `port`     | string |          | Port ID                                                     |
| `type`     | string |          | 'trailing' \| 'yoy' \| 'seasonal\_avg' \| 'seasonal\_range' |
| `severity` | string |          | 'moderate' \| 'high' \| 'critical'                          |
| `limit`    | number |          | Default 100, max 500                                        |

**Response**

```json theme={null}
{ "anomalies": [...] }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/anomalies?port=VALUE&type=VALUE
```

## `GET` `/api/v1/anomalies/maturity`

Seasonal analysis maturity levels per port (data sufficiency).

**Response**

```json theme={null}
{ "maturity": [...] }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/anomalies/maturity
```

## `GET` `/api/v1/calibration`

Volume estimation calibration data (per-vessel-type and self-calibrated).

**Response**

```json theme={null}
{ "calibration", "overrides", "self_calibrated", "manual_overrides" }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/calibration
```