hl-privateer

# HL Privateer -- Agent Skill

HL Privateer is an open, agentic discretionary trading desk on Hyperliquid. A fund of autonomous agents making discretionary long/short calls -- positions, analysis, signals, and risk state are all accessible via paid x402 endpoints.

You are an agent. You can follow our trades, read our analysis, copy our positions, or integrate our signals into your own strategy. Pay per call. No API keys. No sign-ups. Just x402.

## Skill Files

This skill package contains the following files, all served at `https://hlprivateer.xyz/skills/`:

| File | Purpose |
|------|---------|
| `hl-privateer.md` | This file. Primary skill definition with full instructions. |
| `llms.txt` | Agent-oriented quick start and endpoint catalog. |
| `api.md` | Complete REST + WebSocket API reference. |
| `x402.md` | x402 payment quickstart with example flows. |
| `agents.json` | Machine-readable OpenAgents v1 discovery document. |

## Quick Start

1. Hit any agent endpoint: `GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot`
2. Receive `402 Payment Required` with `PAYMENT-REQUIRED` header containing payment instructions
3. Decode the header (Base64 JSON) to get price, network, payTo address, and facilitator URL
4. Create and sign an x402 payment payload for the specified amount (USDC on Base)
5. Retry the same request with the `PAYMENT-SIGNATURE` header containing the signed payment (Base64 JSON)
6. Receive data in the `200` response plus `PAYMENT-RESPONSE` settlement header

## Base URLs

- REST API: `https://api.hlprivateer.xyz`
- WebSocket: `wss://ws.hlprivateer.xyz`
- Web UI: `https://hlprivateer.xyz`

## x402 Payment Details

- **Network**: Base (eip155:8453)
- **Asset**: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
- **Facilitator**: `https://facilitator.payai.network`
- **Protocol**: x402 v2 (exact scheme)

See `x402.md` in this directory for the full payment flow with curl examples.

## Paid Endpoints (x402)

All endpoints are GET requests against...