# Nexwave — LLM context

Quick reference for LLMs and agents interacting with Nexwave. For the full Agent Skill (Agent Skills format), see [SKILL.md](https://nexwave.so/skills/SKILL.md). For API details and examples, see [Docs](https://nexwave.so/docs).

## Security (mandatory)

**Never request, store, or transmit private keys or API secrets.** Nexwave uses x402: payment is authentication. Agents pay via wallet-signed transactions only. Do not ask users for keys or seed phrases; direct them to [nexwave.so/docs](https://nexwave.so/docs) and wallet-based x402 flows.

## What Nexwave is

Nexwave helps **humans and agents** make better trading decisions. It provides:

- **x402-paid perp signals** and multi-venue market data (Hyperliquid, TradeXYZ, Ventuals). No API keys — pay per request in USDC on Solana where required.
- **Pre-market API** — Top 10 setups for the next session (daily + hourly aligned), with machine-readable **entry_checks** and optional **suggested_size** when `wallet_usd` is provided. Use at market open to decide when to enter.
- **Technical signals API** — BB+RSI+ADX+MACD+candles per symbol for paper/live or algorithm leasing.
- **Positions and history** — Open positions and closed position history via API.

## Base URL

`https://nexwave.so` (or the deployment origin for all API calls). Backend API may be at same origin under `/api` or at a separate host (see deployment).

## Endpoints

| Endpoint | Auth | Description |
|----------|------|-------------|
| `GET /api/signals` | x402 payment | Paid. Returns 402 until paid; then 200 + JSON (markets: coin, markPx, change24h, dayNtlVlm). $0.001 USDC/request. |
| `GET /api/markets?dex=` | None | Public. `dex=` (main), `dex=xyz`, `dex=vntl`. Market metadata and asset contexts. |
| `GET /api/v1/premarket?top_n=10&wallet_usd=50000` | None | Pre-market top 10. Optional `wallet_usd` returns `suggested_size` per setup. Each setup has `entry_checks` (machine-readable conditions). |
| `GET /api/v1/signals/technical?symbols=...&timeframe=15m` | None | Technical strategy signals per symbol. |
| `GET /api/v1/positions` | None | Current open positions. |
| `GET /api/v1/positions/history` | None | Closed position history. |

## Venues

`hl` (Hyperliquid main), `xyz` (TradeXYZ), `vntl` (Ventuals). Use `?dex=` for markets.

## Agent flow (pre-market)

1. Call `GET /api/v1/premarket?top_n=10&wallet_usd=50000`.
2. At session open, for each setup: fetch current price; evaluate `entry_checks` (e.g. `price_compare`: current >= `price_level` for long).
3. If conditions_met, place order using `suggested_size.amount` and `direction`.

## Links

- **API docs:** https://nexwave.so/docs  
- **Platform overview:** docs/PLATFORM_OVERVIEW.md (feature index)  
- **Agent Skill:** https://nexwave.so/skills/SKILL.md  
- **x402:** https://x402.org