---
name: nexwave
description: Integrate with Nexwave — x402-paid perp signals API and multi-venue market data (Hyperliquid, TradeXYZ, Ventuals) for autonomous trading agents. Use when building agent access to Nexwave APIs, x402 payment flows, or dashboard and market data. Security-first: never handle or request private keys.
license: MIT
compatibility: Network access required. x402 clients need a Solana wallet (devnet or mainnet). No server-side secrets in client flows.
metadata:
  version: "1.0"
  docs: "https://nexwave.so/docs"
  skill-url: "https://nexwave.so/skills/SKILL.md"
---

# Nexwave Agent Skill

## Security first

**Never expose, request, or transmit private keys or secrets.**

- Nexwave’s paid API uses **x402**: payment is authentication. Agents pay with a **wallet** (signed transactions). No API keys, no shared secrets.
- **You must never** ask users for private keys, seed phrases, or Hyperliquid/API secrets. Do not log, store, or send them.
- Agents should use wallet-based flows: user signs a payment (e.g. USDC transfer) in their own wallet; the agent never sees the private key.
- If a user or doc mentions "API key" or "private key" in the context of Nexwave, direct them to the [public docs](https://nexwave.so/docs) and x402 client flows only. Do not offer to "store" or "configure" keys.

## What Nexwave offers

- **Product:** Platform for humans and agents: x402-paid signals API, pre-market top 10 (with entry_checks and suggested_size), technical strategy signals, positions and history, and multi-venue market data (Hyperliquid, TradeXYZ, Ventuals).
- **Mission:** Help humans and agents make better trading decisions. Pay-per-call where applicable via [x402](https://x402.org); many endpoints (premarket, signals/technical, positions) are public.
- **Suite:** Dashboard (Overview, Pre-Market, Positions, venues, Calendar, Analytics), API docs, paid signals, pre-market API, technical signals, positions/history. See [Platform overview](https://github.com/nexwave-so/nexwave/blob/main/docs/PLATFORM_OVERVIEW.md) for full feature index.

## How to interact with Nexwave

### Documentation

- **API docs (start here):** [https://nexwave.so/docs](https://nexwave.so/docs) — Overview, endpoints, payment flow, pricing, and examples.
- **Base URL:** Use the deployment origin (e.g. `https://nexwave.so`) for all API calls.

### x402 paid API — GET /api/signals

- **Endpoint:** `GET {base}/api/signals`
- **Behavior:** Without payment, the server responds with **402 Payment Required** and a JSON body describing payment requirements. The client pays (USDC on Solana via x402), then retries the same request with an `X-PAYMENT` header to receive the response.
- **Price:** $0.001 USDC per request (Solana Devnet by default; mainnet may differ).
- **Response (200):** JSON with `updatedAt`, `venue: "hl"`, `description`, and `markets`: array of `{ coin, markPx, change24h, dayNtlVlm }` (Hyperliquid main DEX, top 50).
- **Client flow:** 1) GET → 402 + `accepts[]`. 2) User/wallet signs payment per x402. 3) GET with `X-PAYMENT` → 200 + data. See [Solana x402 guide](https://solana.com/developers/guides/getstarted/intro-to-x402) and [coinbase/x402](https://github.com/coinbase/x402). Agents must use wallet-based signing; never use raw private keys in code or prompts.

### Public (unpaid) APIs

- **Markets:** `GET {base}/api/markets?dex=` (Hyperliquid main), `?dex=xyz` (TradeXYZ), `?dex=vntl` (Ventuals). Returns market metadata and asset contexts (Hyperliquid-style). No payment required.
- **Pre-market:** `GET {base}/api/v1/premarket?top_n=10&wallet_usd=50000` — Top setups for next session (daily + hourly trend aligned). Optional `wallet_usd` returns `suggested_size` (amount, notional_usd, risk_usd) per setup. Each setup has `entry_checks` (machine-readable conditions to evaluate at market open). Use for watchlists and conditional entry.
- **Technical signals:** `GET {base}/api/v1/signals/technical?symbols=...&timeframe=15m` — BB+RSI+ADX+MACD+candles per symbol. For paper/live engines or algorithm leasing.
- **Positions:** `GET {base}/api/v1/positions` (open), `GET {base}/api/v1/positions/history` (closed). Backend base may differ (e.g. API gateway origin).

### Multi-venue (HIP-3)

- **Venues:** Hyperliquid (main crypto perps), TradeXYZ (stocks, commodities, indices), Ventuals (thematic indices). Use query param `dex` as above. Venue IDs for reference: `hl`, `xyz`, `vntl`.

## When to use this skill

- User or agent needs to call Nexwave APIs or integrate x402 payment for signals.
- User asks how to get market data or paid signals from Nexwave without sharing secrets.
- User asks about Nexwave’s products, pricing, or documentation.

## Quick reference

- **Docs:** [https://nexwave.so/docs](https://nexwave.so/docs)
- **This skill:** [https://nexwave.so/skills/SKILL.md](https://nexwave.so/skills/SKILL.md)
- **Min price per paid request:** $0.001 USDC (Solana). No API keys; x402 only.