OKX OnChainOS — Répertoire de compétences
À quoi sert ce fichier : c'est une page de répertoire qui pointe vers le dépôt officiel
onchainos-skillsd'OKX. Il ne contient aucune logique propre — chaque sous-compétence ci-dessous vit en amont surokx/onchainos-skillset est récupérée à l'installation, vous garantissant ainsi la dernière version.
OKX OnChainOS est une suite de 8 sous-compétences spécialisées couvrant le trading en chaîne, les analyses de marché, les signaux de smart money, l'investissement DeFi et les positions, les opérations de portefeuille, l'analyse de sécurité, les protocoles de paiement, l'identité des agents et le marché de tâches, ainsi que les actualités crypto et le sentiment sur plus de 20 blockchains (Ethereum, Solana, XLayer, Base, BSC, Arbitrum, Polygon, Optimism, Avalanche, TRON, …).
La plupart des sous-compétences utilisent un binaire unique, onchainos, téléchargé lors de la première utilisation. Un sous-ensemble de fonctionnalités (données en lecture seule) peut également être utilisé sans le binaire, via le sc-proxy de Starchild — voir Options d'authentification ci-dessous.
Comment fonctionne l'installation
# Installer une sous-compétence (recommandé — télécharge uniquement ce dont vous avez besoin)
npx skills add okx/onchainos-skills@<nom-sous-compétence>
# Ou via la forme longue
npx skills add https://github.com/okx/onchainos-skills --skill <nom-sous-compétence>
# Tout installer (détecte automatiquement votre environnement et installe en conséquence)
npx skills add okx/onchainos-skills
Chaque sous-compétence livre son propre SKILL.md + documentation de référence + phrases déclencheurs, vous pouvez donc télécharger uniquement ce dont vous avez besoin.
Marketplace de plugins (alternative) :
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skills
Installation CLI (le binaire onchainos — détecte automatiquement la plateforme, vérifie le SHA256, installe dans ~/.local/bin ou %USERPROFILE%\.local\bin) :
# macOS / Linux
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
# ajoutez `-s -- --beta` pour la dernière pré-version (uniquement sur option ; ne jamais rétrograder)
# Windows
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
Portefeuille — utiliser par défaut le portefeuille de l'agent
Utilisez le skill wallet de la plateforme pour signer et diffuser. Les points de terminaison OKX DEX renvoient des calldata non signés ({to, value, data, ...}) ; transmettez-les à wallet_transfer(data=<calldata>) et le tour est joué. Aucun portefeuille OKX séparé n'est nécessaire.
N'utilisez le portefeuille TEE OnchainOS (onchainos wallet login <email>) que lorsque l'utilisateur le demande explicitement.
Options d'authentification (lisez ceci avant d'invoquer quoi que ce soit)
Il existe deux chemins distincts. Choisissez en fonction de ce que l'agent doit faire :
Chemin A — HTTP direct via le sc-proxy Starchild (aucune clé API requise)
Pour les consultations de données en lecture seule (prix, chandeliers, signaux smart money, analyses de tokens, vérifications de sécurité, portefeuilles d'adresses publiques — ≈ 80% des capacités d'OnchainOS), l'agent peut ignorer complètement la CLI et appeler https://web3.okx.com/... directement via le sc-proxy :
from core.http_client import proxied_get
r = proxied_get(
"https://web3.okx.com/api/v6/dex/aggregator/supported/chain",
headers={"SC-CALLER-ID": f"chat:{thread_id}"},
)
Le sc-proxy injecte automatiquement les identifiants OKX de la plateforme, signe chaque requête avec HMAC-SHA256 et facture les crédits Starchild de l'appelant.
- Coût : 0,001 $ / requête
- Limite de débit : 60 req/min
- Configuration : aucune
- Limites : données uniquement — impossible d'envoyer des transactions ou de gérer des portefeuilles
Chemin B — CLI onchainos avec votre propre clé API OKX Web3
Pour les opérations de portefeuille (wallet login, wallet send, wallet contract-call), les swaps DEX nécessitant une exécution, les paiements et tout autre flux de travail piloté par CLI.
La CLI onchainos est livrée avec des clés API sandbox intégrées qui fonctionnent directement pour les tests locaux — aucune configuration requise. Ces clés sont partagées, limitées en débit et réservées à l'évaluation : ne les utilisez PAS en production ou avec des actifs réels. Tout échec ou perte résultant de l'utilisation des clés intégrées relève de la responsabilité de l'appelant.
Pour la production, apportez vos propres identifiants :
- Faites une demande sur web3.okx.com → OnchainOS → Portail Développeur
- Définissez les variables d'environnement (ou un fichier
.envà la racine du projet — ne le commitez jamais) :export OKX_API_KEY=<votre clé> export OKX_SECRET_KEY=<votre secret> export OKX_PASSPHRASE=<votre phrase de passe> - Exécutez les commandes CLI de n'importe quelle sous-compétence.
Pourquoi la CLI ne peut pas utiliser le sc-proxy
Le binaire onchainos utilise la pile TLS rustls de Rust avec webpki-roots intégrés — une copie au moment de la compilation de la liste des AC racines de Mozilla. Il ignore le magasin de confiance système, ignore SSL_CERT_FILE et n'a aucun remplacement de variable d'environnement documenté. Par conséquent, le certificat MITM du sc-proxy est rejeté comme UnknownIssuer, et la CLI ne peut pas être proxyfiée de manière transparente. Le Chemin A (HTTP direct depuis les scripts de l'agent) est le seul moyen d'utiliser les identifiants de la plateforme avec OnchainOS aujourd'hui.
La création de portefeuille (onchainos wallet login <email>) vous donne un nouveau compte géré par TEE — elle n'importe PAS votre portefeuille OKX App / extension existant.
Sous-compétences par catégorie
📊 Découverte & Données de Marché (2)
| Sous-compétence | Utilisation pour |
|---|---|
okx-dex-market | Données DEX en lecture seule en chaîne : prix en temps réel / chandeliers / indice / PnL du portefeuille, suivi des activités d'adresses, signaux smart money / baleines / KOL + classements, recherche de tokens / métadonnées / capitalisation boursière / classements / liquidité / tokens chauds / analyse des détenteurs et clusters / meilleurs traders / historique des transactions, actualités crypto / sentiment / tendances / classement KOL, analyse des lancements de memes / tranchées / réputation du développeur / détection de bundles, et flux en temps réel WS/script |
okx-dapp-discovery | Découverte de DApps tierces et routage direct de plugins — prend actuellement en charge Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Optimiseur Morpho V1 |
💼 Portefeuille, Trading & Sécurité (1)
| Sous-compétence | Utilisation pour |
|---|---|
okx-agentic-wallet | Cycle de vie du portefeuille (authentification, solde, PnL du portefeuille, envoi, historique des transactions, appel de contrat), Station-service, Swap DEX, pont inter-chaînes, stratégie d'ordre limité, passerelle de transaction (gaz / simulation / diffusion / suivi de commande), portefeuille d'adresses publiques, analyse de sécurité (risque de token, hameçonnage DApp, vérification des transactions et signatures, approbations), journal d'audit |
🏦 DeFi (1)
| Sous-compétence | Utilisation pour |
|---|---|
okx-defi | DeFi agrégé par OKX : découverte de produits, dépôt, retrait, réclamation de récompenses sur Aave, Lido, PancakeSwap, Kamino, NAVI et plus, ainsi qu'aperçu des positions et avoirs sur plusieurs protocoles et chaînes |
💸 Paiements (1)
| Sous-compétence | Utilisation pour |
|---|---|
okx-agent-payments-protocol | Répartiteur de paiement unifié pour x402 (schémas exact / aggr_deferred — clé TEE ou locale), MPP (intentions charge / session — ouverture / bon / rechargement / fermeture, mode transaction ou hachage) et a2a-pay (création / paiement / statut basé sur paymentId). Route vers des références par schéma/intention. |
🤖 Agent et IA (2)
| Sous-compétence | Utilisation pour |
|---|---|
okx-ai | Identité d'agent en chaîne ERC-8004 (enregistrer / mettre à jour / rechercher / évaluer / liste de services) + marché de tâches d'agent (publier / accepter / livrer / contester) + suivi en direct de la progression des tâches |
okx-guide | Intégration et centre d'aide : intégration Onchain OS + bannière de bienvenue, introduction à OKX.AI et routage d'inscription aux rôles, assistance client / orientation vers le centre d'aide |
🛠️ Opérations (1)
| Sous-compétence | Utilisation pour |
|---|---|
okx-growth-competition | Concours de trading exclusifs pour portefeuilles agentiques : lister, participer, voir le classement, réclamer des récompenses |
Correspondance rapide tâche → sous-compétence
| Je veux… | Sous-compétence | Chemin suggéré |
|---|---|---|
| Vérifier le prix d'un token ou un graphique | okx-dex-market | A (pas de clé) |
| Rechercher / analyser les détenteurs d'un token | okx-dex-market | A (pas de clé) |
| Suivre les achats de smart money | okx-dex-market | A (pas de clé) |
| Analyser les nouveaux lancements de memes | okx-dex-market | A (pas de clé) |
| Consulter un portefeuille public | okx-agentic-wallet (portefeuille d'adresses publiques) | A (pas de clé) |
| Analyser les risques d'un token / dApp | okx-agentic-wallet (analyse de sécurité) | A (pas de clé) |
| Estimer le gaz / simuler une tx | okx-agentic-wallet (passerelle) | A ou B |
| Gérer / envoyer depuis mon propre portefeuille | okx-agentic-wallet | B (connexion requise) |
| Échanger des tokens | okx-agentic-wallet (swap DEX) Appel REST + signature avec le skill wallet (Portefeuille Agent) | |
| Trouver le meilleur rendement DeFi (n'importe quel protocole) | okx-defi | B (signature) |
| Voir mes positions DeFi | okx-defi | A (pas de clé) |
| Utiliser une DApp spécifique (Aave, Polymarket, …) | okx-dapp-discovery | B (flux DApp complet) |
| Payer une ressource verrouillée x402 / MPP / a2a-pay | okx-agent-payments-protocol | B (signature) |
| Enregistrer / évaluer un agent en chaîne, marché de tâches d'agent | okx-ai | B (signature) |
| Intégration, présentation OKX.AI, support client | okx-guide | A (pas de clé) |
| Participer à un concours de trading | okx-growth-competition | B (portefeuille requis) |
| Déboguer une panne CLI | okx-agentic-wallet (journal d'audit) | B (journaux CLI locaux) |
Workflows — orchestrations multi-compétences préconstruites
Au-delà des sous-compétences individuelles, le dépôt fournit des orchestrations de workflows sous workflows/ qui composent plusieurs compétences en une seule opération complète. L'agent lit workflows/INDEX.md pour router une demande, puis suit les instructions étape par étape dans le fichier de workflow correspondant.
| Workflow | Ce qu'il fait | Commande CLI |
|---|---|---|
| Recherche de Token | Prix, sécurité, détenteurs, cluster, signaux smart money, analyse approfondie facultative du launchpad | onchainos workflow token-research --address <addr> |
| Brève Quotidienne | Pulsation du marché + smart money + activité des nouveaux tokens + alertes de portefeuille | — |
| Signaux Smart Money | Liste des signaux SM agrégés par token + due diligence par token | onchainos workflow smart-money |
| Analyse des Nouveaux Tokens | Analyse du launchpad MIGRATED + enrichissement sécurité et développeur pour les 10 premiers | onchainos workflow new-tokens |
| Analyse de Portefeuille | PnL sur 7j/30j, comportement de trading, activité récente en chaîne | onchainos workflow wallet-analysis --address <addr> |
| Vérification de Portefeuille | Soldes, valeur totale, aperçu du PnL sur 30j | onchainos workflow portfolio --address <addr> |
| Surveillance de Portefeuille | Interrogation en session — alerter sur les nouveaux trades des portefeuilles surveillés | — |
| Surveillance de Portefeuille (WS) | Session WebSocket en arrière-plan pour la surveillance hors ligne du portefeuille | — |
Commandes CLI composites
Des commandes uniques qui remplacent plusieurs appels d'outils individuels :
# Rapport token : info + prix + infos avancées + analyse de sécurité (en parallèle)
onchainos token report --address <addr> --chain solana
# Commandes de workflow complètes
onchainos workflow token-research --address <addr> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <addr> [--chain ethereum]
onchainos workflow portfolio --address <addr> [--chains ethereum,solana]
Flux de compétences typiques
- Rechercher et acheter :
okx-dex-market(trouver un token) →okx-agentic-wallet(vérifier les fonds + exécuter le trade) - Aperçu du portefeuille :
okx-agentic-wallet(avoirs) →okx-dex-market(enrichir avec des analyses + graphiques de prix) - Recherche de marché :
okx-dex-market(tendances/classements + chandeliers/historique) →okx-agentic-wallet(trader) - Swap et diffusion :
okx-agentic-wallet(obtenir un devis → échanger → diffuser → suivre la commande) - Flux de trading complet :
okx-dex-market(recherche + prix/graphique) →okx-agentic-wallet(vérifier le solde → échanger → simuler + diffuser + suivre) - Classement → recherche → trade :
okx-dex-market(meilleurs traders par PnL/taux de gain + analyses de token) →okx-agentic-wallet(exécuter le trade) - Suivre la smart money :
okx-dex-market(achats KOL/smart money + détails du token + cluster de détenteurs + graphique de prix) →okx-agentic-wallet(trader)
Serveur MCP
La CLI onchainos fait également office de serveur MCP natif, exposant ses outils à tout client compatible MCP. Démarrez-le avec :
onchainos mcp
Notes importantes
- Identifiants de chaîne : les noms humains (
ethereum,solana,xlayer) et les ID numériques sont acceptés. Exécutezonchainos swap chainsouonchainos gateway chainspour la liste complète. - Opérations en lecture seule (données de marché, signaux, analyse de sécurité, portefeuilles d'adresses publiques) fonctionnent via le Chemin A sans aucune clé API fournie par l'utilisateur.
- Trading et envoi utilisent par défaut le portefeuille de l'agent via le skill
wallet. Ne recourez àonchainos wallet loginque lorsque l'utilisateur le demande. - Barrière de sécurité : lorsque l'analyse de sécurité de
okx-agentic-walletsignale un échec, l'agent appelant DOIT bloquer l'opération concernée plutôt que de continuer.
Ressources
- Dépôt amont : okx/onchainos-skills
- Documentation OnchainOS : OKX Web3 Build — OnchainOS
- Registre des compétences : skills.sh/okx/onchainos-skills
- Portail développeur (clé API) : web3.okx.com/onchain-os/dev-portal