Nexus Trading Labs — Agent Skill

⚠️ CRITIQUE — LIS CECI D'ABORD

Chaque action authentifiée nécessite une signature de portefeuille. Obtiens-la une fois, réutilise-la pour la session.

Étape 1 — request_additional_tools({ names: ["sign_message"] })
Étape 2 — commit_to_tools({ keep: ["sign_message"] })
Étape 3 — sign_message({ message: "nexus-trading-key-v1" }) → enregistre en walletSig
         capture également walletAddress du portefeuille connecté

⛔ NE SAUTE PAS cette étape. Pas de walletSig = erreur 401 sur tous les endpoints authentifiés. ⛔ NE DEMANDE PAS à l'utilisateur une signature. Tu as sign_message — utilise-le toi-même.

⛔ INTERDICTIONS

NE JAMAIS appeler trade.nexustradinglabs.com pour les requêtes API — c'est l'app frontend statique. Elle retourne 405 sur tous les POSTs.
NE JAMAIS préfixer /api/ ou /api/v1/ aux chemins d'endpoints — il n'y a pas de tel préfixe sur cette API.
NE JAMAIS construire les URLs à partir de chemins relatifs — utilise toujours l'URL complète du tableau de référence rapide.
NE JAMAIS intégrer stopLoss / takeProfit dans le corps /trade — place-les via /set-sl-tp après exécution
NE JAMAIS stocker ou logger la clé API Bankr — utilise-la de manière transitoire par appel, jamais persistante
NE JAMAIS demander à l'utilisateur d'exécuter des commandes terminal, d'installer des packages, ou de signer manuellement des messages
NE JAMAIS utiliser la CLI Orderly (@orderly.network/cli)
NE JAMAIS rappeler sign_message avant chaque requête — une signature par session suffit

Trade (action la plus courante)

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

Si la réponse est { error: "wallet_not_registered" } → exécute le flux d'enregistrement (voir references/trading.md).

Pour attacher SL/TP après exécution : POST /set-sl-tp (voir references/trading.md — ne mets jamais SL/TP dans /trade).

Référence Rapide

⚠️ UTILISE TOUJOURS l'URL complète : https://og.nexustradinglabs.com

Action	URL complète	Auth
Placer un trade	`POST https://og.nexustradinglabs.com/trade`	walletSig
Fermer une position	`POST https://og.nexustradinglabs.com/close-position`	walletSig
Attacher SL/TP	`POST https://og.nexustradinglabs.com/set-sl-tp`	walletSig
Annuler un ordre	`POST https://og.nexustradinglabs.com/cancel`	walletSig
Statut de l'ordre	`POST https://og.nexustradinglabs.com/order-status`	walletSig
Historique des ordres	`POST https://og.nexustradinglabs.com/order-history`	walletSig
Positions	`POST https://og.nexustradinglabs.com/positions`	walletSig
Solde	`POST https://og.nexustradinglabs.com/balance`	walletSig
Définir le levier	`POST https://og.nexustradinglabs.com/set-leverage`	walletSig
Déposer l'USDC	`POST https://og.nexustradinglabs.com/proxy/bankr-deposit`	Clé API Bankr
Retirer l'USDC	`POST https://og.nexustradinglabs.com/proxy/bankr-withdraw`	Clé API Bankr + walletSig
Régler le PnL	`POST https://og.nexustradinglabs.com/settle-pnl`	walletSig
Enregistrer le portefeuille	`POST https://og.nexustradinglabs.com/proxy/bankr-register`	Clé API Bankr
Publier la thèse on-chain	`POST https://og.nexustradinglabs.com/proxy/thesis-register`	Clé API Bankr
Prix de marque	`GET https://og.nexustradinglabs.com/mark-price?symbol=BTC`	public
Taux de financement	`GET https://og.nexustradinglabs.com/funding-rate?symbol=BTC`	public
Stats 24h	`GET https://og.nexustradinglabs.com/24h-stats?symbol=BTC`	public
Flux public	`GET https://og.nexustradinglabs.com/feed`	public
Trader lab	`GET https://og.nexustradinglabs.com/lab/:wallet`	lecture publique
Profil du trader	`GET https://og.nexustradinglabs.com/profile/:wallet`	lecture publique
Classement	dérivé de `GET https://og.nexustradinglabs.com/feed` + `getTraderStats()`	public
Intelligence de marché	`GET https://api-evm.orderly.org/v1/public/futures`	public
Actualités crypto	proxy rss2json (voir references/news.md)	public

Charger les Références As Needed

references/trading.md — flux de trade complet, enregistrement, SL/TP, fermeture, annulation, statut-de-l'ordre, historique-des-ordres, positions, levier
references/deposit-withdraw.md — dépôt d'USDC, retrait, règlement du PnL, solde
references/feed-leaderboard.md — flux public, flux de copie de thèse, registre on-chain, Rep Score, construction du classement, notifications, commentaires
references/market-data.md — prix de marque, taux de financement, stats 24h, codes d'erreur, logique de retry, limites de débit, testnet
references/intel.md — intelligence de marché : extrait l'OI en direct, les taux de financement, les signaux de régime de l'API publique Orderly
references/news.md — extrait les dernières actualités crypto/macro via les flux RSS avant de cadrer un trade ou de répondre aux questions de marché