nexus

What this skill does

# Nexus Trading Labs — Agent Skill

## ⚠️ CRITICAL — READ THIS BEFORE ANYTHING ELSE

**Every authenticated action requires a wallet signature. Get it once, reuse for the session.**

```
Step 1 — request_additional_tools({ names: ["sign_message"] })
Step 2 — commit_to_tools({ keep: ["sign_message"] })
Step 3 — sign_message({ message: "nexus-trading-key-v1" }) → save as walletSig
         also capture walletAddress from the connected wallet
```

**⛔ DO NOT skip this.** No walletSig = 401 error on every authenticated endpoint.
**⛔ DO NOT ask the user for a signature.** You have `sign_message` — use it yourself.

---

## ⛔ FORBIDDEN

- NEVER call `trade.nexustradinglabs.com` for API requests — that is the static frontend app. It returns 405 on all POSTs.
- NEVER prepend `/api/` or `/api/v1/` to endpoint paths — there is no such prefix on this API.
- NEVER construct URLs from relative paths — always use the full URL from the quick reference table.
- NEVER embed `stopLoss` / `takeProfit` in the `/trade` body — place them via `/set-sl-tp` after fill
- NEVER store or log the Bankr API key — use it transiently per call, never persist
- NEVER ask the user to run terminal commands, install packages, or sign messages manually
- NEVER use the Orderly CLI (`@orderly.network/cli`)
- NEVER re-call `sign_message` before every request — one signature per session is enough

---

## Trade (most common action)

```
POST https://og.nexustradinglabs.com/trade
{
  "symbol":      "PERP_BTC_USDC",   // or shorthand "BTC"
  "side":        "BUY",             // or "SELL"
  "notional":    50,                // USD size
  "leverage":    5,
  "walletSig":   "<from sign_message>",
  "walletAddress": "<connected wallet>"
}
```

If response is `{ error: "wallet_not_registered" }` → run Registration Flow (see references/trading.md).

To attach SL/TP after fill: `POST /set-sl-tp` (see references/trading.md — never put SL/TP in /trade).

---

## Quick Reference

⚠️ **ALWAYS use the full URL: `https://og.nexustradinglabs.com`**

| Action | Full URL | Auth |
|---|---|---|
| Place trade | `POST https://og.nexustradinglabs.com/trade` | walletSig |
| Close position | `POST https://og.nexustradinglabs.com/close-position` | walletSig |
| Attach SL/TP | `POST https://og.nexustradinglabs.com/set-sl-tp` | walletSig |
| Cancel order | `POST https://og.nexustradinglabs.com/cancel` | walletSig |
| Order status | `POST https://og.nexustradinglabs.com/order-status` | walletSig |
| Order history | `POST https://og.nexustradinglabs.com/order-history` | walletSig |
| Positions | `POST https://og.nexustradinglabs.com/positions` | walletSig |
| Balance | `POST https://og.nexustradinglabs.com/balance` | walletSig |
| Set leverage | `POST https://og.nexustradinglabs.com/set-leverage` | walletSig |
| Deposit USDC | `POST https://og.nexustradinglabs.com/proxy/bankr-deposit` | Bankr API key |
| Withdraw USDC | `POST https://og.nexustradinglabs.com/proxy/bankr-withdraw` | Bankr API key + walletSig |
| Settle PnL | `POST https://og.nexustradinglabs.com/settle-pnl` | walletSig |
| Register wallet | `POST https://og.nexustradinglabs.com/proxy/bankr-register` | Bankr API key |
| Publish thesis on-chain | `POST https://og.nexustradinglabs.com/proxy/thesis-register` | Bankr API key |
| Mark price | `GET https://og.nexustradinglabs.com/mark-price?symbol=BTC` | public |
| Funding rate | `GET https://og.nexustradinglabs.com/funding-rate?symbol=BTC` | public |
| 24h stats | `GET https://og.nexustradinglabs.com/24h-stats?symbol=BTC` | public |
| Public feed | `GET https://og.nexustradinglabs.com/feed` | public |
| Trader lab | `GET https://og.nexustradinglabs.com/lab/:wallet` | public read |
| Trader profile | `GET https://og.nexustradinglabs.com/profile/:wallet` | public read |
| Leaderboard | derive from `GET https://og.nexustradinglabs.com/feed` + `getTraderStats()` | public |
| Market intel | `GET https://api-evm.orderly.org/v1/public/futures` | public |
| Crypto news | rss2json proxy (see references/news.md) | public |

---

## Load References As Needed

- **references/trading.md** — full trade flow, registration, SL/TP, close, cancel, order-status, order-history, positions, leverage
- **references/deposit-withdraw.md** — deposit USDC, withdraw, settle PnL, balance
- **references/feed-leaderboard.md** — public feed, thesis copy flow, on-chain registry, Rep Score, leaderboard build, notifications, comments
- **references/market-data.md** — mark price, funding rate, 24h stats, error codes, retry logic, rate limits, testnet
- **references/intel.md** — market intelligence: pull live OI, funding rates, regime signals from Orderly public API
- **references/news.md** — pull latest crypto/macro news via RSS feeds before framing a trade or answering market questions