OKX OnChainOS — Diretório de Skills
O que este arquivo é: uma página de diretório que aponta para o repositório oficial de skills
onchainos-skillsda OKX. Ele não contém lógica própria — cada sub-skill listado abaixo reside no repositório upstream emokx/onchainos-skillse é buscado fresco na instalação, para que você sempre obtenha a versão mais recente.
O OKX OnChainOS é um conjunto de 8 sub-skills especializados que cobrem operações on-chain: trading, análises de mercado, sinais de smart money, investimentos e posições em DeFi, operações de carteira, varredura de segurança, protocolos de pagamento, identidade de agentes e marketplace de tarefas, e notícias e sentimento do mercado cripto em mais de 20 blockchains (Ethereum, Solana, XLayer, Base, BSC, Arbitrum, Polygon, Optimism, Avalanche, TRON, …).
A maioria dos sub-skills utiliza um único binário, onchainos, que é baixado no primeiro uso.
Um subconjunto de capacidades (dados somente leitura) também pode ser acessado sem o binário,
via sc-proxy da Starchild — veja Opções de autenticação abaixo.
Como a instalação realmente funciona
# Instalar um sub-skill (recomendado — baixa apenas o necessário)
npx skills add okx/onchainos-skills@<nome-do-sub-skill>
# Ou via formato longo
npx skills add https://github.com/okx/onchainos-skills --skill <nome-do-sub-skill>
# Instalar tudo (detecta automaticamente seu ambiente e instala de acordo)
npx skills add okx/onchainos-skills
Cada sub-skill vem com seu próprio SKILL.md + documentação de referência + frases de gatilho, para que você possa baixar apenas o que precisa.
Marketplace de plugins (alternativa):
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skills
Instalação via CLI (o binário onchainos — detecta automaticamente a plataforma, verifica SHA256,
instala em ~/.local/bin ou %USERPROFILE%\local\bin):
# macOS / Linux
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
# Adicione `-s -- --beta` para a última pré-versão (opt-in apenas; nunca faz downgrade)
# Windows
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
Carteira — padrão é a carteira do agente do usuário
Use o skill wallet da plataforma para assinar e transmitir transações. Os endpoints
DEX da OKX retornam calldata não assinado ({to, value, data, ...}); alimente-o
em wallet_transfer(data=<calldata>) e pronto. Nenhuma carteira OKX separada é necessária.
Use a carteira TEE da OnchainOS (onchainos wallet login <email>) apenas quando
o usuário solicitar explicitamente.
Opções de autenticação (leia antes de invocar qualquer coisa)
Existem dois caminhos distintos. Escolha com base no que o agente precisa fazer:
Caminho A — HTTP direto via sc-proxy da Starchild (nenhuma chave de API necessária)
Para consultas de dados somente leitura (preços, gráfico K-line, sinais de smart money, análises de token,
verificações de segurança, portfólios de endereços públicos — ≈ 80% das capacidades do OnchainOS),
o agente pode pular o CLI completamente e chamar
https://web3.okx.com/... diretamente através do 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}"},
)
O sc-proxy injeta automaticamente as credenciais OKX da plataforma, assina cada requisição com HMAC-SHA256 e debita os créditos Starchild do chamador.
- Custo: $0.001 / requisição
- Limite de taxa: 60 req/min
- Configuração: nenhuma
- Limitações: apenas dados — não pode enviar transações ou gerenciar carteiras
Caminho B — CLI onchainos com sua própria chave de API OKX Web3
Para operações de carteira (wallet login, wallet send, wallet contract-call),
trocas DEX que precisam de execução, pagamentos e qualquer outro fluxo de trabalho orientado por CLI.
O CLI onchainos vem com chaves de API sandbox embutidas que funcionam imediatamente
para testes locais — nenhuma configuração necessária. Essas chaves são compartilhadas, com limite de taxa,
e apenas para avaliação: NÃO as use em produção ou com ativos reais. Quaisquer
falhas ou perdas decorrentes do uso das chaves embutidas são de responsabilidade do chamador.
Para produção, traga suas próprias credenciais:
- Solicite em web3.okx.com → OnchainOS → Dev Portal
- Defina variáveis de ambiente (ou um arquivo
.envna raiz do projeto — nunca o commite):export OKX_API_KEY=<sua chave> export OKX_SECRET_KEY=<seu segredo> export OKX_PASSPHRASE=<sua frase secreta> - Execute qualquer comando CLI do sub-skill.
Por que o CLI não pode usar sc-proxy
O binário onchainos usa a pilha TLS rustls do Rust com webpki-roots embutidos
— uma cópia em tempo de compilação da lista de CAs raiz da Mozilla. Ele ignora
o armazenamento de confiança do sistema, ignora SSL_CERT_FILE e não tem nenhuma
variável de ambiente documentada para sobrescrever. Como resultado, o CA MITM do sc-proxy
é rejeitado como UnknownIssuer, e o CLI não pode ser proxy transparentemente.
O Caminho A (HTTP direto a partir de scripts do agente) é a única maneira de usar
credenciais da plataforma com OnchainOS hoje.
A criação de carteira (onchainos wallet login <email>) gera uma nova conta gerenciada por TEE —
ela NÃO importa sua carteira existente do aplicativo/extensão OKX.
Sub-skills por categoria
📊 Descoberta e Dados de Mercado (2)
| Sub-skill | Usar para |
|---|---|
okx-dex-market | Dados DEX on-chain somente leitura: preços em tempo real / gráfico K-line / índice / PnL de carteira, atividades de rastreador de endereços, rastreamento de sinais de smart money / baleia / KOL + classificações de leaderboard, busca de token / metadados / market cap / classificações / liquidez / tokens populares / análise de holders e clusters / principais traders / histórico de negociações, notícias cripto / sentimento / vibe / leaderboard de KOL, varredura de meme pump / trenches / reputação de desenvolvedor / detecção de bundle, e transmissão em tempo real via WS/script |
okx-dapp-discovery | Descoberta de DApps de terceiros e roteamento direto de plugins — atualmente suporta Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer |
💼 Carteira, Trading e Segurança (1)
| Sub-skill | Usar para |
|---|---|
okx-agentic-wallet | Ciclo de vida da carteira (autenticação, saldo, portfólio PnL, envio, histórico de transações, chamada de contrato), Gas Station, troca DEX, ponte cross-chain, estratégia de ordem limite, gateway de transação (gas / simular / transmitir / rastrear ordem), portfólio de endereço público, varredura de segurança (risco de token, phishing em DApps, verificação de transações e assinaturas, aprovações), log de auditoria |
🏦 DeFi (1)
| Sub-skill | Usar para |
|---|---|
okx-defi | DeFi agregado pela OKX: descoberta de produtos, depósito, retirada, reivindicação de recompensas em Aave, Lido, PancakeSwap, Kamino, NAVI e mais, além de visão geral de posições e participações entre protocolos e cadeias |
💸 Pagamentos (1)
| Sub-skill | Usar para |
|---|---|
okx-agent-payments-protocol | Despachante unificado de pagamentos entre x402 (esquemas exact / aggr_deferred — TEE ou chave local), MPP (intenções charge / session — open / voucher / topUp / close, modo de transação ou hash) e a2a-pay (criar / pagar / status baseado em paymentId). Roteia para referências por esquema/intenção. |
🤖 Agente e IA (2)
| Sub-skill | Usar para |
|---|---|
okx-ai | Identidade de agente on-chain ERC-8004 (registrar / atualizar / buscar / avaliar / listar serviços) + marketplace de tarefas de agente (publicar / aceitar / entregar / disputar) + monitor de progresso de tarefas ao vivo |
okx-guide | Hub de onboarding e guia: onboarding do Onchain OS + banner de boas-vindas, introdução ao OKX.AI e roteamento de registro de função, orientação de suporte ao cliente / Central de Ajuda |
🛠️ Operações (1)
| Sub-skill | Usar para |
|---|---|
okx-growth-competition | Competições de trading exclusivas para carteiras agênticas: listar, participar, ver leaderboard, reivindicar recompensas |
Mapa rápido de tarefa → sub-skill
| Eu quero… | Sub-skill | Caminho sugerido |
|---|---|---|
| Verificar preço ou gráfico de um token | okx-dex-market | A (sem chave) |
| Buscar / analisar holders de um token | okx-dex-market | A (sem chave) |
| Seguir compras de smart money | okx-dex-market | A (sem chave) |
| Escanear novos lançamentos de meme | okx-dex-market | A (sem chave) |
| Ver qualquer carteira pública | okx-agentic-wallet (portfolio de endereço público) | A (sem chave) |
| Escanear risco de um token / dApp | okx-agentic-wallet (varredura de segurança) | A (sem chave) |
| Estimar gas / simular uma transação | okx-agentic-wallet (gateway) | A ou B |
| Gerenciar / enviar da minha própria carteira | okx-agentic-wallet | B (requer login) |
| Trocar tokens | okx-agentic-wallet (troca DEX) REST + assinar com o skill wallet (Agent Wallet) | |
| Encontrar o melhor rendimento DeFi (qualquer protocolo) | okx-defi | B (assinatura) |
| Ver minhas posições DeFi | okx-defi | A (sem chave) |
| Usar um DApp específico (Aave, Polymarket, …) | okx-dapp-discovery | B (fluxo DApp completo) |
| Pagar um recurso com gate x402 / MPP / a2a-pay | okx-agent-payments-protocol | B (assinatura) |
| Registrar / avaliar um agente on-chain, marketplace de tarefas de agente | okx-ai | B (assinatura) |
| Onboarding, introdução ao OKX.AI, suporte ao cliente | okx-guide | A (sem chave) |
| Participar de uma competição de trading | okx-growth-competition | B (carteira necessária) |
| Depurar uma falha do CLI | okx-agentic-wallet (log de auditoria) | B (logs locais do CLI) |
Fluxos de trabalho — orquestrações multi-skill pré-construídas
Além dos sub-skills individuais, o repositório oferece orquestrações de fluxo de trabalho em
workflows/ que combinam várias habilidades em uma única operação completa. O agente
lê workflows/INDEX.md para rotear uma requisição e, em seguida, segue as instruções
passo a passo no arquivo de fluxo de trabalho correspondente.
| Fluxo de trabalho | O que faz | Comando CLI |
|---|---|---|
| Token Research | Preço, segurança, holders, cluster, sinais de smart money, mergulho opcional em launchpad | onchainos workflow token-research --address <addr> |
| Daily Brief | Pulso do mercado + smart money + atividade de novos tokens + alertas de portfólio | — |
| Smart Money Signals | Lista de sinais de SM agregados por token + devida diligência por token | onchainos workflow smart-money |
| New Token Screening | Varredura de launchpad MIGRATED + segurança e enriquecimento de desenvolvedor para os top 10 | onchainos workflow new-tokens |
| Wallet Analysis | PnL de 7d/30d, comportamento de trading, atividade on-chain recente | onchainos workflow wallet-analysis --address <addr> |
| Portfolio Check | Saldos, valor total, visão geral de PnL de 30 dias | onchainos workflow portfolio --address <addr> |
| Wallet Monitor | Polling durante a sessão — alerta sobre novas negociações de carteiras monitoradas | — |
| Wallet Monitor (WS) | Sessão WebSocket em segundo plano para monitoramento offline de carteira | — |
Comandos CLI compostos
Comandos únicos que substituem múltiplas chamadas de ferramentas individuais:
# Relatório de token: informações + preço + informações avançadas + varredura de segurança (paralelo)
onchainos token report --address <addr> --chain solana
# Comandos de fluxo de trabalho completos
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]
Fluxos típicos de habilidades
- Pesquisar e comprar:
okx-dex-market(encontrar token) →okx-agentic-wallet(verificar fundos + executar negociação) - Visão geral do portfólio:
okx-agentic-wallet(participações) →okx-dex-market(enriquecer com análises + gráficos de preço) - Pesquisa de mercado:
okx-dex-market(tendências/classificações + candles/histórico) →okx-agentic-wallet(negociar) - Trocar e transmitir:
okx-agentic-wallet(obter cotação → trocar → transmitir → rastrear ordem) - Fluxo completo de trading:
okx-dex-market(pesquisar + preço/gráfico) →okx-agentic-wallet(verificar saldo → trocar → simular + transmitir + rastrear) - Leaderboard → pesquisa → negociar:
okx-dex-market(principais traders por PnL/taxa de acerto + análises de token) →okx-agentic-wallet(executar negociação) - Seguir smart money:
okx-dex-market(compras de KOL/smart money + detalhes do token + cluster de holders + gráfico de preço) →okx-agentic-wallet(negociar)
Servidor MCP
O CLI onchainos também atua como um servidor MCP nativo, expondo suas ferramentas para qualquer
cliente compatível com MCP. Inicie-o com:
onchainos mcp
Notas importantes
- Identificadores de cadeia: tanto nomes humanos (
ethereum,solana,xlayer) quanto IDs numéricos são aceitos. Executeonchainos swap chainsouonchainos gateway chainspara a lista completa. - Operações somente leitura (dados de mercado, sinais, varredura de segurança, portfólios de endereços públicos) funcionam via Caminho A sem nenhuma chave de API fornecida pelo usuário.
- Trading e envio padrão para a carteira do agente do usuário através do skill
wallet. Só recorra aonchainos wallet loginquando o usuário solicitar. - Gate de segurança: quando a varredura de segurança do
okx-agentic-walletreportar uma falha, o agente chamador DEVE bloquear a operação relacionada em vez de prosseguir.
Recursos
- Repositório upstream: okx/onchainos-skills
- Documentação do OnchainOS: OKX Web3 Build — OnchainOS
- Registro de skills: skills.sh/okx/onchainos-skills
- Portal do desenvolvedor (chave de API): web3.okx.com/onchain-os/dev-portal