bankrbot/nexus

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