> ## 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.

# Earnings & Freight

> Voyage earnings estimates, freight rates, and time-charter equivalent calculations across vessel classes — endpoints for shipping economics and chartering.

Voyage earnings estimates and freight rate data.

## `GET` `/api/v1/earnings`

Per-voyage earnings estimates.

**Parameters**

| Name     | Type   | Required | Description         |
| -------- | ------ | -------- | ------------------- |
| `vessel` | string |          | IMO number          |
| `port`   | string |          | Port slug           |
| `limit`  | number |          | Default 50, max 200 |

**Response**

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

**Example**

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

## `GET` `/api/v1/earnings/port-revenue`

Weekly port revenue aggregates.

**Parameters**

| Name    | Type   | Required | Description         |
| ------- | ------ | -------- | ------------------- |
| `port`  | string |          | Port slug           |
| `limit` | number |          | Default 52, max 200 |

**Response**

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

**Example**

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

## `GET` `/api/v1/freight-rates`

Freight rate data by vessel type.

**Parameters**

| Name          | Type   | Required | Description         |
| ------------- | ------ | -------- | ------------------- |
| `vessel_type` | string |          | Vessel type filter  |
| `limit`       | number |          | Default 50, max 200 |

**Response**

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

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/freight-rates?vessel_type=VALUE&limit=VALUE
```

## `POST` `/api/v1/freight-rates`

<Note>Requires API key.</Note>

Submit a new freight rate record.

**Response**

```json theme={null}
{ "freight_rate": {...} }
```

**Example**

```bash theme={null}
curl -X POST -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/freight-rates \
  -d '{"key":"value"}'
```