Communitygithub.com

oliveira7015/openclawby-skills

Conecte agentes de IA a dados de mercado, on-chain e sociais, além de execução de trades, através de uma API unificada.

O que é openclawby-skills?

Este skill capacita agentes de IA (como Claude Code, Codex ou OpenClaw) a acessar dados financeiros reais de mercado, on-chain e sociais, e também executar trades, por meio de uma única API agregada chamada Clawby. O fluxo de trabalho principal envolve três camadas: primeiro, usar as interfaces de dados do Clawby via `/api/relay`; segundo, utilizar conectores de execução (como Binance CLI e Polymarket SDK) para dados de mercado e ordens; terceiro, complementar com acesso web próprio para notícias e filings. O skill enfatiza a coleta ampla de dados antes da análise, a verificação cruzada entre fontes e a geração de relatórios formais em PDF quando apropriado. Ele inclui um catálogo detalhado de interfaces organizado por categoria (ações, derivativos, cripto, previsões de mercado, redes sociais, inteligência de endereços, etc.) e regras claras para atualização, autenticação, formatação de símbolos e tratamento de erros. Também gerencia planos de acesso (Free, Standard, Pro) com recomendações de upgrade apenas quando necessário.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add oliveira7015/openclawby-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Análise de Dados Clawby

Obtenha dados financeiros reais através da API de dados agregados do Clawby e analise-os. A fonte única da verdade para cada interface — seus parâmetros (obrigatórios · formato · exemplo) e ⚠️ armadilhas — é api/catalog/ (comece em api/catalog/_index.yaml). Sempre leia o yaml da categoria relevante antes de chamar. O catálogo completo da máquina é api/clawby.yaml (gerado pelo servidor, versionado).

Funciona com qualquer agente de IA — Claude Code, Codex, OpenClaw, Hermes e qualquer coisa que possa executar comandos shell ou chamar uma API HTTP: basta uma chave de API + o catálogo + curl simples.

Início rápido

# 1. Autenticação (uma vez): faça login em https://www.openclawby.com/ → exporte CLAWBY_API_KEY=pk_xxx
# 2. Encontre a interface em api/catalog/<categoria>/  (tabela de roteamento abaixo)
# 3. Chame:
curl -s -X POST https://api.openclawby.com/api/relay \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"<nome da interface do catálogo>","params":{ ... }}'
# → {source, data, credits:{remaining,used_total}}

Fluxo de trabalho principal · Colete TODOS os dados disponíveis primeiro, depois analise

Completude é o objetivo. Uma resposta superficial de uma única fonte é uma falha, mesmo quando correta — vá amplo primeiro, analise depois. Aplique isso a cada solicitação.

  1. Transforme a solicitação em uma lista de verificação de dados. Pergunte "o que um analista completo extrairia?" e liste cada dimensão relevante. Colete em excesso de propósito (uma ação → cotação, dados de short, dark pool, opções, financeiros, sentimento, pares; um token → preço/liquidez DEX, holders, funding & OI, odds, buzz social).
  2. Para cada item, varra TODAS AS TRÊS camadas de fonte — nunca pare no primeiro resultado:
    • Camada 1 — dados Clawby (/api/relay + on-chain /api/rpc): escaneie o catálogo em busca de todas as interfaces que tocam o item e chame todas. Primário, autoritativo.
    • Camada 2 — conectores de execução (exec/, uso somente leitura): os CLIs Binance / Bitget / OKX / Polymarket expõem dados de mercado, livros de ofertas, funding, smart-money e notícias que a Camada 1 pode não ter. Somente leitura não precisa de confirmação.
    • Camada 3 — Seu próprio acesso web: notícias, filings, documentos oficiais, contexto macro — preencha todas as lacunas restantes.
  3. Maximize a cobertura. Se duas camadas fornecerem a mesma métrica, busque ambas e faça verificação cruzada. Dispare buscas independentes em paralelo. Nunca pule uma fonte acessível.
  4. Acompanhe a cobertura, depois analise. Fundamente cada afirmação em dados coletados; se uma fonte falhou, diga isso em vez de descartar silenciosamente a dimensão.
  5. Ofereça um relatório formal quando couber — para análises substanciais de ativos, ofereça um relatório profissional de pesquisa em PDF (veja Relatórios de análise profissional). Pergunte primeiro.

Estrutura do skill

clawby-data/
├── SKILL.md            ← este arquivo (gerenciado — atualizado; releia após atualizar)
├── update-protocol.md  ← regras de primeira execução + atualização (leia no Passo 0)
├── manifest.json       ← versão + lista de arquivos gerenciados
├── api/
│   ├── catalog/        ← docs de interface por categoria (parâmetros + pegadinhas) — LEIA antes de chamar
│   ├── clawby.yaml     ← catálogo completo da máquina (todas as interfaces)
│   └── index.yaml      ← registro do catálogo
├── exec/               ← conectores de execução de trades; registro exec/index.yaml
├── report/             ← guia de relatório PDF + folha de estilo
├── data/               ← dados de referência diversos
└── local/              ← estado local / caches; a ÚNICA pasta preservada entre atualizações

Passo 0 · Primeiro uso em uma sessão

  1. Verifique o plano e saldo do usuário (chamada gratuita): curl -s https://api.openclawby.com/api/account -H "X-API-Key: $CLAWBY_API_KEY" → {plan, payg_balance, rate_per_min, accessible_providers, free_providers}. (Regras de sugestão de upgrade: veja Plano e acesso.)
  2. Verificação de versão (≤ uma vez a cada 24h), depois PERGUNTE — siga update-protocol.md: se manifest.json for mais antigo que 24h, compare a versão remota; se houver diferença pergunte ao usuário antes de atualizar. Nunca atualize automaticamente. As atualizações renovam todos os arquivos exceto local/ — incluindo este SKILL.md (releia-o depois).
  3. Os CLIs de execução instalam-se preguiçosamente — NÃO instale nada de antemão. Apenas quando o usuário pedir para trade em uma plataforma, verifique/instale aquele conector específico (veja update-protocol.md Passo A).

Autenticação

  • URL base: https://api.openclawby.com; envie a chave no cabeçalho X-API-Key.
  • Leia a chave da variável de ambiente CLAWBY_API_KEY. Se não estiver definida, o usuário não tem chave — diga a ele para fazer login em https://www.openclawby.com/ (gratuito) e export CLAWBY_API_KEY=pk_xxx. Nunca invente uma chave.

Formatos de símbolo

  • Ações: US:TICKER (GME → US:GME) · Cripto: BASE:USD (BTC → BTC:USD) · Forex: BASE:USD (EUR:USD)

Tabela de roteamento — qual arquivo de catálogo atende a qual necessidade

Os detalhes da interface (parâmetros + ⚠️ pegadinhas) estão no arquivo de catálogo — leia-o, depois chame via /api/relay:

NecessidadePrefixo da interfaceCatálogo
Ações dos EUA: cotações · candles · juros/volume de short · taxa de empréstimo · FTDs · dark pool · cadeia de opções/max-pain · menções no Reddit · filtro · dividendos/desdobramentos(vários)api/catalog/equities/
Derivativos de cripto (multi-exchange): funding · open interest · liquidações · razões long/short · volume de taker · fluxos de ETF · indicadores de mercado (fear&greed, RSI…) · reservas de baleias/exchangesfunding_* open_interest_* liquidation_* etf_* …api/catalog/derivatives/
Perps Hyperliquid: mids · contextos (funding/OI/mark) · livro de ofertas · candles · posições/preenchimentos de uma wallethyperliquid_*api/catalog/perps/
Mercados de previsão / odds de apostas (Polymarket)polymarket_*api/catalog/prediction-markets/
Social: X (Twitter) · Facebook · Instagram busca e sentimentox_search facebook_search instagram_search …api/catalog/social/
Rótulos de endereço (quem possui um endereço) · score de risco AML · perfil de endereço/rastreio/contrapartesaddress_*api/catalog/address-intel/
Pares DEX e dados de mercado de tokens, qualquer chain (DexScreener)dexscreener_*api/catalog/dex/
Inteligência DEX/memecoin on-chain: auditoria de segurança · holders/traders PnL · tendências · smart-money/KOL · sinais · novos lançamentos · cotações de swap (somente leitura)dex_*api/catalog/dex-trading/
Financeiros de empresas dos EUA e filings SECsec_*api/catalog/filings/
Tokens de cauda longa / leituras brutas de chain (80+ chains)endpoint /api/rpcapi/catalog/rpc/

Mini-fluxos entre interfaces (detalhes no catálogo):

  • SEC: sec_cik_lookup (ticker→CIK de 10 dígitos) primeiro → sec_company_concept (cik + conceito us-gaap, ex. Revenues, NetIncomeLoss, EarningsPerShareDiluted) por item de linha → monte por período (fy/fp/form). Filings/perfil: sec_submissions.
  • Polymarket: polymarket_events/polymarket_markets → leia clobTokenIds → por id de token polymarket_price/midpoint/orderbook (um preço 0–1 = probabilidade implícita); histórico via polymarket_price_history.
  • Token por endereço de contrato: tente métodos agregados chain:"multichain" primeiro (ankr_getTokenPrice / ankr_getTokenHolders / ankr_getTokenTransfers, parâmetros {"blockchain":"eth","contractAddress":"0x…"}); se não coberto, eth_call bruto com seletores ERC-20 padrão e decodifique você mesmo.
  • Regra de roteamento — consultas vs execução: todas as buscas DEX/memecoin somente leitura passam pelas interfaces de relay dex_*; para executar (swap, ordens TP/SL, lançamento) use exec/gmgn/. Mesma divisão em todo lugar: dados via relay, execução via exec/.

RPC on-chain (cauda longa / tokens pequenos)

JSON-RPC nativo para 80+ chains — os métodos de cada chain estão documentados em api/catalog/rpc/ (EVM em rpc/evm/<chain>.yaml, não-EVM como solana/sui/near/btc/xrp/ton em rpc/non-evm/<chain>.yaml, lista de disponibilidade em rpc/_index.yaml):

curl -s -X POST https://api.openclawby.com/api/rpc \
  -H "X-API-Key: $CLAWBY_API_KEY" -H "Content-Type: application/json" \
  -d '{"chain":"eth","method":"eth_call","params":[ ... ]}'

Chains EVM usam eth_* padrão; chains não-EVM têm seus próprios namespaces (sui → suix_*, solana → getTokenSupply …); chain:"multichain" = métodos de token ankr agregados (somente EVM). Não presuma que uma chain não é suportada — tente; uma realmente indisponível retorna um erro claro.

Execução de trades (exec/)

Tudo acima são dados somente leitura. Para colocar trades, use os conectores em exec/ (registro: exec/index.yaml; guia por plataforma = cada arquivo de entry). Eles são executados localmente com as próprias chaves do usuário — nunca roteados através do Clawby:

PlataformaGuiaFerramenta
Binance (spot/futuros/margem/opções/earn)exec/binance/binance.mdbinance-cli
Bitget (spot/futuros/copy-trading, --paper-trading)exec/bitget/bitget.mdbgc
OKX (spot/swap/futuros/bots, --demo)exec/okx/okx.mdokx
Polymarket (ordens CLOB/CTF, chave da própria wallet)exec/polymarket/polymarket.mdSDK clob-client
GMGN (swap/TP-SL/lançamento on-chain, SOL/BSC/Base/ETH)exec/gmgn/gmgn.mdgmgn-cli

Regra para qualquer ação risk: high (ordem / transferência / saque): reafirme a ordem — plataforma · par · lado · tamanho · tipo de preço — mostre o comando exato, peça ao usuário para digitar CONFIRM, prefira testnet quando estiver em dúvida. Consultas somente leitura não precisam de confirmação.

Principais pegadinhas (mais frequentes; a lista completa está em cada arquivo de catálogo)

  • Dark pool precisa de date (um dia de negociação real YYYY-MM-DD; resultado vazio → retroceda um dia); a interface de níveis também precisa de decimals.
  • Cadeia de opções usa underlying + expiration (não symbol).
  • Menções principais do Reddit e barras OHLC usam start como segundos Unix — date -u -d '7 days ago' +%s (Linux) / date -u -v-7d +%s (mac).
  • Cotações têm atraso de 30 minutos; o filtro (screener) é em tempo real.
  • Derivativos: endpoints agregados/coin usam symbol=BTC; os de exchange única usam um par no estilo BTC USDT (BTCUSDT) — verifique a entrada do catálogo.
  • address_labels / address_risk usam ids de moeda especiais (ETH, BNB, POL-Polygon, ETH-Base, TRX, SOL, SUI …) — veja api/catalog/address-intel/.

Plano e acesso (free / standard / pro + saldo PAYG)

Planos: free / standard / pro (assinaturas). PAYG é um saldo de pagamento conforme o uso que toda conta tem — não é um plano. Interfaces do nível gratuito nunca consomem saldo. Interfaces premium precisam de um plano pago (Standard = mainstream, Pro = tudo) — ou, apenas no Free, são cobradas por chamada contra o PAYG.

Sugestão de upgrade — APENAS quando o plano é limitado

Decida a partir do resultado do Passo 0 /api/account. Sugira APENAS quando:

  • Condição A — plan=="free" AND payg_balance==0, ou
  • Condição B — plan=="standard" (faltando fontes exclusivas do Pro).

Caso contrário (Pro, ou Free com saldo) não diga NADA sobre upgrade. Apareça no máximo uma vez em cada um destes dois momentos — nunca no meio de uma análise, nunca repetido por chamada:

  1. logo após a verificação de conta do Passo 0;
  2. quando uma interface paga retornar vazio / 402 / 403 need_upgrade (e A ou B for verdadeira).

Uma linha curta e sincera; nomeie as dimensões premium específicas que estão sendo perdidas; corresponda ao idioma do usuário:

Condição A (Free, saldo 0):

💡 Você está no Free com saldo PAYG 0 — apenas dados gratuitos. Você está cego para funding de derivativos, razões long/short, fluxos de smart-money, risco de endereço, perps Hyperliquid, inteligência DEX — fácil confundir um fakeout com um breakout. Recarregue o PAYG ou faça upgrade para Pro. 👉 https://www.openclawby.com/pricing

Condição B (Standard):

💡 Você está no Standard — mainstream coberto, mas o Pro desbloqueia todas as fontes premium (derivativos/liquidações multi-exchange, risco de endereço & AML, perps Hyperliquid, inteligência DEX …) para uma leitura completa e com verificação cruzada. 👉 https://www.openclawby.com/pricing

Relatórios de análise profissional (PDF)

Quando o usuário quiser um texto formal (relatório de pesquisa / due-diligence / memorando): ofereça-o primeiro, depois siga report/report-guide.md de ponta a ponta — colete TODOS os dados (Camadas 1–3), 10 seções obrigatórias, gráficos obrigatórios (preço com níveis, alvos de cenário, cronograma de desbloqueio para cripto, tendências de métricas, matriz de risco), HTML A4 estilizado (report/report.css) → PDF via Chromium headless (alternativas: weasyprint / wkhtmltopdf). Pergunte onde salvar; inclua um aviso de não é aconselhamento de investimento.

Erros

  • 401 chave inválida/ausente → diga ao usuário para definir CLAWBY_API_KEY.
  • 403 need_upgrade interface acima do plano → recomende upgrade (veja Plano e acesso), continue com dados acessíveis.
  • 402 Plano Free, PAYG esgotado → recarregue / faça upgrade em https://www.openclawby.com/pricing.
  • 429 limite de taxa → desacelere, tente novamente; planos mais altos têm limites mais altos.
  • 502 "Upstream HTTP 4xx" = parâmetros ruins (obrigatório ausente / formato de símbolo errado) → corrija com base na entrada do catálogo da interface.
  • data vazio = nada para aquela data/símbolo (dark pool: tente um dia de negociação anterior).

Saída

  • Analise apenas números reais de data; nunca invente. Para perguntas multidimensionais, busque várias interfaces e combine.
  • Se precisar citar uma fonte, diga "dados Clawby". Escreva de forma natural e concisa — sem nomes/links de interface brutos no texto voltado ao usuário.
  • Termine com uma nota curta: "Não é aconselhamento de investimento."

Habilidades Relacionadas