> For the complete documentation index, see [llms.txt](https://docs.hydromancer.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hydromancer.xyz/readme/hyena/quickstart.md).

# Quickstart

### Quickstart

Data is accessed via S3 using read-only credentials.

**Bucket:** `hyena-hip3` **Paths:** `hourly/*`, `daily/*`

**To get access:**

1. Request a key from the team
2. You'll receive a personal access key (AWS Access Key ID + Secret)

**Setup:**

```bash
# Install AWS CLI (if needed)
# macOS: brew install awscli
# Linux: apt install awscli / yum install awscli
# Or: pip install awscli

# Configure credentials
aws configure --profile hyena-data
# AWS Access Key ID: <your-key>
# AWS Secret Access Key: <your-secret>
# Default region name: ap-northeast-1
# Default output format: None
```

**Usage:**

```bash
# List available exports
aws s3 ls s3://hyena-hip3/hourly/ --profile hyena-data
aws s3 ls s3://hyena-hip3/daily/ --profile hyena-data

# Download a file
aws s3 cp s3://hyena-hip3/hourly/raw/fills/perp/date=2025-12-15/hour=09/09_fills.parquet . --profile hyena-data

# Sync a full day
aws s3 sync s3://hyena-hip3/hourly/raw/fills/perp/date=2025-12-15/ ./data/ --profile hyena-data
```

For more details see [Data export overview](/readme/hyena/data-export-overview.md)