# ExKey

> ExKey is a quantitative investment research firm. It publishes the daily
> performance history of its two proprietary systematic strategies — **ExKey
> Trends** (CTA trend following) and **STTS** (short-term trading) — as a public,
> read-only data feed. No account, no API key, no authentication is required.
> This file tells AI agents and tools how to fetch that data directly instead of
> scraping the website.

Each strategy exposes two daily index series: **gross** (before fees) and **net**
(after hypothetical management & performance fees). Values are index levels, base
100 at each strategy's inception. Total return between two dates = value(end) /
value(start) - 1.

## Performance Data API

Public, read-only, no authentication, CORS open to all origins. Method: GET.

- On-domain endpoint (recommended): https://exkey.fr/api/performance
- Direct origin (equivalent, always available): https://oupsuoxangwogoqvcgxt.supabase.co/functions/v1/performance

Endpoints (either base works):

- Manifest — self-describing, lists strategies, fields, and every endpoint:
  https://exkey.fr/api/performance
- STTS, JSON:  https://exkey.fr/api/performance?strategy=stts
- STTS, CSV:   https://exkey.fr/api/performance?strategy=stts&format=csv
- ExKey Trends, JSON: https://exkey.fr/api/performance?strategy=key-trends
- ExKey Trends, CSV:  https://exkey.fr/api/performance?strategy=key-trends&format=csv

Parameters:
- `strategy` (required for data): `stts` or `key-trends`.
- `format`: `json` (default) or `csv`.

Response fields (`date`, `gross`, `net`):
- `date`: trading day, ISO 8601 `YYYY-MM-DD`.
- `gross`: gross index level (number), or null when unavailable for that date.
- `net`: net index level (number), or null when unavailable for that date.

CSV format: comma-separated, `.` decimal separator, UTF-8, header row
`date,gross,net`, one row per trading day, full history.

JSON shape: `{ "meta": { ...strategy, series labels, coverage, disclaimer... },
"data": [ { "date": "YYYY-MM-DD", "gross": <number|null>, "net": <number|null> } ] }`.

Rate limit: a shared global cap plus a per-network cap (no user is identified).
On limit, the API returns HTTP 429 with a `Retry-After` header — back off and retry.

### Examples

```
# Discover everything (strategies + endpoints):
curl "https://exkey.fr/api/performance"

# Download STTS full daily history as CSV:
curl "https://exkey.fr/api/performance?strategy=stts&format=csv" -o exkey_stts.csv

# Latest ExKey Trends point as JSON:
curl "https://exkey.fr/api/performance?strategy=key-trends" | jq '.data[-1]'
```

## Notes

- Data are the result of simulations (backtests), not audited live trading
  results. Gross = before fees; net = after hypothetical fees. Past performance
  is not indicative of future results. Provided for information only; not
  investment advice.
- Website: https://exkey.fr
- Strategy pages: https://exkey.fr/STTS and https://exkey.fr/KeyTrends