# PortSignal API

> Maritime lineup data marketplace REST API

## Authentication

All requests require `X-API-Key` header.
Key format: `ps_` followed by 32 hex characters.

## Endpoints

### GET /v1/lineups
Returns lineup records from subscribed feeds.
Query: source, port, country, port_name, from, to, latest, commodity (comma-separated leaf/group/subgroup names, case-insensitive), limit (max 500), cursor
Auth: X-API-Key header required

### GET /v1/sources
Lists subscribed data sources with port, frequency, and quality ratings.
Auth: X-API-Key header required

### GET /v1/schema/:sourceId
Field schema and coverage stats for a specific source.
Auth: X-API-Key header required

## Rate Limits
100 requests/minute per API key.
429 response with Retry-After header on exceeded.

## Error Format
```json
{ "error": { "code": "ERROR_CODE", "message": "Description" } }
```

## Full Reference
See /llm-full.txt for complete field documentation and examples.