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.
- 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).
- 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.
- Camada 1 — dados Clawby (
- 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.
- 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.
- 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
- 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.) - Verificação de versão (≤ uma vez a cada 24h), depois PERGUNTE — siga
update-protocol.md: semanifest.jsonfor 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 excetolocal/— incluindo este SKILL.md (releia-o depois). - 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.mdPasso A).
Autenticação
- URL base:
https://api.openclawby.com; envie a chave no cabeçalhoX-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) eexport 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:
| Necessidade | Prefixo da interface | Catá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/exchanges | funding_* open_interest_* liquidation_* etf_* … | api/catalog/derivatives/ |
| Perps Hyperliquid: mids · contextos (funding/OI/mark) · livro de ofertas · candles · posições/preenchimentos de uma wallet | hyperliquid_* | api/catalog/perps/ |
| Mercados de previsão / odds de apostas (Polymarket) | polymarket_* | api/catalog/prediction-markets/ |
| Social: X (Twitter) · Facebook · Instagram busca e sentimento | x_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/contrapartes | address_* | 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 SEC | sec_* | api/catalog/filings/ |
| Tokens de cauda longa / leituras brutas de chain (80+ chains) | endpoint /api/rpc | api/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→ leiaclobTokenIds→ por id de tokenpolymarket_price/midpoint/orderbook(um preço 0–1 = probabilidade implícita); histórico viapolymarket_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_callbruto 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) useexec/gmgn/. Mesma divisão em todo lugar: dados via relay, execução viaexec/.
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:
| Plataforma | Guia | Ferramenta |
|---|---|---|
| Binance (spot/futuros/margem/opções/earn) | exec/binance/binance.md | binance-cli |
Bitget (spot/futuros/copy-trading, --paper-trading) | exec/bitget/bitget.md | bgc |
OKX (spot/swap/futuros/bots, --demo) | exec/okx/okx.md | okx |
| Polymarket (ordens CLOB/CTF, chave da própria wallet) | exec/polymarket/polymarket.md | SDK clob-client |
| GMGN (swap/TP-SL/lançamento on-chain, SOL/BSC/Base/ETH) | exec/gmgn/gmgn.md | gmgn-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 realYYYY-MM-DD; resultado vazio → retroceda um dia); a interface de níveis também precisa dedecimals. - Cadeia de opções usa
underlying+expiration(nãosymbol). - Menções principais do Reddit e barras OHLC usam
startcomo 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 estiloBTC 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…) — vejaapi/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"ANDpayg_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:
- logo após a verificação de conta do Passo 0;
- 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_upgradeinterface 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.
datavazio = 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."