Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

Mercados de previsão Polymarket ao seu alcance - consulte odds, acompanhe portfólios, pesquise mercados com análise por IA, compare mercados e negocie. Abrange todas as 4 APIs do Polymarket: Gamma, CLOB, Data API, RTDS WebSocket e Bridge. Comandos somente leitura funcionam instantaneamente (sem configuração). O skill de mercados de previsão mais abrangente no ClawHub.

O que é clawdbot-skill-polymarket?

Este skill para agentes de IA permite consultar e negociar em mercados de previsão do Polymarket diretamente do terminal, usando linguagem natural. Ele oferece funcionalidades completas: navegar por mercados, pesquisar eventos, comparar odds lado a lado, acompanhar portfólios com P&L, transmitir dados em tempo real via WebSocket, fazer bridging de fundos entre blockchains e executar ordens de compra e venda (limit, market e post-only). O skill integra as quatro APIs oficiais do Polymarket (Gamma, CLOB, Data e RTDS) mais a Bridge, mas a maioria das operações de leitura (como trending, pesquisa e detalhes de eventos) funciona imediatamente sem necessidade de instalação. Para funcionalidades avançadas como livro de ofertas, histórico de preços e negociação, é necessário instalar o Polymarket CLI (Rust) e configurar uma carteira. O agente usa scripts Python para todos os comandos, formatando a saída em tabelas e relatórios estruturados, e antes de executar qualquer negociação, ele sempre exibe os detalhes da ordem (tipo, lado, preço, tamanho, custo estimado e taxas) para que o usuário confirme a operação.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

Perguntar na sua IA favorita

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

Documentação

Polymarket

Consulte mercados de previsão do Polymarket e negocie pelo terminal. Navegue por odds, pesquise eventos, compare mercados, acompanhe seu portfólio, transmita dados ao vivo, faça bridge de fundos e execute negociações - tudo por meio de linguagem natural.

O Polymarket expõe 4 APIs separadas, além da camada de conveniência Gamma. Este skill cobre todas elas.

Configuração

Comandos somente leitura funcionam imediatamente (sem instalação necessária). Navegação, pesquisa, tendências, categorias, pesquisa de mercado e modo de comparação usam a API Gamma pública.

Para negociação, livros de ofertas, histórico de preços e funcionalidades avançadas, instale o Polymarket CLI (binário Rust, v0.1.5+):

brew install polymarket/tap/polymarket-cli

Para negociar, configure uma carteira:

polymarket wallet create
polymarket approve set

Ou configure manualmente ~/.config/polymarket/config.json com sua chave privada. Consulte a documentação do CLI para detalhes.

O CLI também fornece um REPL interativo:

polymarket shell

Use --output json em qualquer comando do CLI para saída legível por máquina, adequada para scripts e pipes.

Comandos

Navegar por Mercados (sem CLI necessário)

# Mercados em tendência/ativos (ordenados por volume em 24h)
python3 {baseDir}/scripts/polymarket.py trending

# Tendências com mais resultados
python3 {baseDir}/scripts/polymarket.py trending --limit 20

# Pesquisar mercados por palavra-chave
python3 {baseDir}/scripts/polymarket.py search "trump"

# Obter evento específico por slug
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# Obter mercados por categoria
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business

Painel de Mercados em Tendência (sem CLI necessário)

Mostre um painel categorizado dos mercados mais quentes do Polymarket. Combine trending com filtros de categoria para construir uma visão geral completa.

# Painel de tendências completo - execute estes em sequência para construir um panorama:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5

Quando o usuário pedir um "painel" ou "visão geral", execute todas as consultas de categoria e apresente os resultados agrupados por seção com cabeçalhos claros. Inclua volume e odds atuais para cada mercado.

Modo de Pesquisa de Mercado (sem CLI necessário)

A pesquisa de mercado combina as odds do Polymarket com análise contextual. Quando o usuário pedir para "pesquisar" um mercado ou quiser uma análise mais profunda além das odds:

  1. Busque os dados do mercado usando comandos de pesquisa ou evento
  2. Analise as odds - o que o mercado implica? Existe uma vantagem?
  3. Forneça contexto - use seu conhecimento para explicar o que impulsiona as odds
  4. Mostre o movimento histórico - se o CLI estiver disponível, obtenha o histórico de preços
  5. Compare com o consenso - como as odds do Polymarket se comparam a pesquisas, opinião de especialistas ou outros mercados de previsão?
# Passo 1: Encontrar o mercado
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"

# Passo 2: Obter dados detalhados do evento
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"

# Passo 3: Se o CLI estiver disponível, obter histórico de preços para mostrar a tendência
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# Passo 4: Verificar profundidade do livro de ofertas para avaliar liquidez
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

Após coletar os dados, sintetize a pesquisa em um relatório estruturado:

  • Odds Atuais: Percentuais Sim/Não e o que implicam
  • Volume e Liquidez: Quanto dinheiro está neste mercado? É líquido o suficiente para negociar?
  • Tendência: As odds estão subindo ou descendo? Houve picos recentes?
  • Contexto: Que eventos do mundo real ou pontos de dados estão impulsionando as odds?
  • Datas-Chave: Quando o mercado será resolvido? Existem catalisadores futuros?
  • Fatores de Risco: O que poderia causar um movimento repentino?

Modo de Comparação de Mercados (sem CLI necessário)

Compare mercados relacionados lado a lado. Útil para encontrar arbitragem, entender probabilidades condicionais ou apenas ver como diferentes resultados se relacionam.

# Compare dois ou mais mercados relacionados pesquisando cada um
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"

Quando o usuário pedir para "comparar mercados" ou "odds lado a lado":

  1. Pesquise cada mercado que o usuário mencionar
  2. Apresente as odds em formato de tabela de comparação
  3. Observe diferenças de volume (maior volume = odds mais confiáveis)
  4. Sinalize quaisquer inconsistências aparentes (ex.: probabilidades que deveriam somar ~100% mas não somam)
  5. Destaque o spread entre resultados relacionados

Formate a comparação como uma tabela:

Comparação de Mercados: Eleição Presidencial 2028

| Candidato    | Sim     | Volume  | Liquidez |
|--------------|---------|---------|----------|
| Trump        | 32,5%   | $4,2M   | Alta     |
| DeSantis     | 18,1%   | $1,8M   | Média    |
| Newsom       | 12,4%   | $890K   | Média    |
| Harris       | 8,7%    | $2,1M   | Média    |

Painel de Portfólio (CLI + carteira necessários)

Veja seu portfólio completo com posições, P&L e ordens abertas em uma única visualização.

# Ver todas as posições abertas
python3 {baseDir}/scripts/polymarket.py positions

# Ver posições de uma carteira específica
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

# Verificar saldo USDC
python3 {baseDir}/scripts/polymarket.py wallet-balance

# Verificar saldo de um token específico
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

# Listar todas as ordens abertas
python3 {baseDir}/scripts/polymarket.py orders

Quando o usuário pedir um "painel de portfólio" ou "como estou indo", execute todos os três comandos (positions, wallet-balance, orders) e apresente uma visão unificada:

  • Posições: Cada posição com preço atual de mercado, seu preço de entrada (se disponível) e P&L não realizado
  • Saldo USDC: Caixa disponível para novas negociações
  • Ordens Abertas: Ordens limitadas pendentes com preço e tamanho
  • Valor Total do Portfólio: Soma das posições + saldo USDC

Livro de Ofertas e Preços (CLI necessário, sem carteira)

# Livro de ofertas de um token
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# Histórico de preços (intervalos: 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# Histórico de preços com número específico de pontos de dados
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48

Carteira (CLI necessário)

polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID

Negociação (CLI + carteira necessários)

Todas as negociações exigem --confirm para serem executadas. Sem ele, a ordem é apenas visualizada. Este é um recurso de segurança - você sempre vê o que acontecerá antes de acontecer.

Transparência de Custos e Taxas

Antes de executar qualquer negociação, o skill exibe:

  • Tipo de ordem: Limite ou Mercado
  • Lado: Compra ou Venda
  • Preço: Seu preço limite (ou "mercado" para ordens a mercado)
  • Tamanho: Número de ações
  • Custo estimado: Preço x Tamanho para ordens limite, ou valor em dólares para ordens a mercado
  • Taxa Polymarket: O Polymarket não cobra taxas de negociação no CLOB (Central Limit Order Book)
  • Taxas de gas: Operações on-chain (aprovações, splits, redeems) exigem MATIC para gas na Polygon. Gas típico: $0,01-0,05
# Visualizar uma ordem limite (sem --confirm = apenas visualização)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# Executar uma ordem limite
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10

# Ordem limite de venda
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10

# Ordem a mercado: comprar $5 ao preço atual
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

# Ordem limite post-only (descansa no livro apenas, nunca toma liquidez - Jan 2026+)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only

Ordens e Posições (CLI + carteira necessários)

# Listar ordens abertas
python3 {baseDir}/scripts/polymarket.py orders

# Cancelar uma ordem específica
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID

# Cancelar todas as ordens
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all

# Ver posições
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

Referência da API

O Polymarket expõe 4 APIs distintas, além da camada de conveniência Gamma. Cada uma serve a um propósito diferente.

1. API Gamma (gamma-api.polymarket.com) - Pública, sem autenticação

A API de alto nível para navegar e pesquisar mercados. Usada por todos os comandos somente leitura.

  • URL Base: https://gamma-api.polymarket.com
  • GET /events - Listar eventos (params: order, ascending, closed, limit, tag_slug)
  • GET /search - Pesquisar mercados (params: query, limit)
  • GET /events/slug/{slug} - Evento por slug
  • GET /comments - Listar e filtrar comentários em mercados
  • GET /profiles/{address} - Perfis públicos de usuários
  • GET /series - Coleções de eventos agrupados (ex.: série "Eleição 2028")
  • GET /sports - Metadados esportivos incluindo times, partidas e critérios de resolução
  • GraphQL: POST /query - Endpoint GraphQL completo com suporte a assinaturas

2. API CLOB (clob.polymarket.com) - Negociação

A API Central Limit Order Book para todas as operações de negociação. Encapsulada pelo Polymarket CLI.

  • URL Base: https://clob.polymarket.com
  • GET /prices-history - Preços históricos (intervalos: 1m, 1h, 6h, 1d, 1w, max)
  • GET /spread - Spread de compra e venda de um token
  • GET /fee-rate - Detalhes da estrutura de taxas
  • GET /rewards - Ganhos diários de maker/taker
  • POST /order - Colocar uma ordem
  • POST /orders - Ordens em lote (até 15 por requisição)
  • DELETE /order/{id} - Cancelar uma ordem
  • Pontuação de ordens - Verifique a elegibilidade de reembolso maker antes de colocar ordens
  • Ordens Post-Only (Jan 2026) - Ordens que apenas descansam no livro, nunca cruzam o spread
  • API Heartbeat (Jan 2026):
    • POST /heartbeat - Deve ser enviado dentro de 10 segundos, caso contrário todas as ordens abertas são canceladas automaticamente
    • Usado por market makers para manter a presença de ordens
    • Se o heartbeat falhar, todas as ordens restantes para aquela chave de API são canceladas

3. API de Dados (data-api.polymarket.com) - Portfólio e Análises

A API dedicada para acompanhamento de portfólio, histórico de negociações e análises de mercado. Sem autenticação necessária para endpoints públicos.

  • URL Base: https://data-api.polymarket.com
  • GET /positions?user={address} - Posições abertas atuais
    • Classificar por: TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL
  • GET /closed-positions?user={address} - Posições fechadas históricas
  • GET /activity?user={address} - Feed de atividade
    • Tipos: TRADE, SPLIT, MERGE, REDEEM, REWARD
  • GET /value?user={address} - Avaliação do portfólio em USD
  • GET /trades - Histórico de negociações
    • Filtrar por: user, market, side
    • Máximo de 500 resultados por página
  • GET /holders?market={conditionId} - Maiores detentores de tokens de um mercado
  • GET /oi - Juros abertos em todos os mercados
  • GET /volume - Volume de negociação em todos os mercados
  • GET /leaderboard - Rankings de traders (período de tempo configurável)

Use a API de Dados para painéis de portfólio e análises. Ela fornece dados de posição mais ricos que a API CLOB, incluindo cálculos de P&L e histórico de atividade.

4. WebSocket RTDS (wss://ws-live-data.polymarket.com) - Streaming em Tempo Real

Streaming de dados em tempo real via WebSocket. Inscreva-se em tópicos para atualizações ao vivo sem polling.

  • URL: wss://ws-live-data.polymarket.com
  • Protocolo: Mensagens JSON sobre WebSocket
  • Tópicos:
    • comments - Atividade de comentários em tempo real
      • Eventos: comment_created, comment_removed, reaction_created, reaction_removed
    • crypto_prices - Preços de criptomoedas em tempo real
      • Ativos: BTC, ETH, SOL, XRP
      • Fontes: Binance + oráculos Chainlink
  • Gerenciamento dinâmico de inscrições - Inscreva-se e cancele inscrição em tópicos dinamicamente dentro de uma única conexão
  • Útil para construir painéis ao vivo, monitorar sentimento de comentários ou rastrear preços de criptomoedas que alimentam mercados de criptomoedas de 5 minutos

5. API Bridge (bridge.polymarket.com) - Depósitos e Saques Cross-chain

Faça bridge de fundos para dentro e fora do Polymarket em várias blockchains.

  • URL Base: https://bridge.polymarket.com
  • POST /deposit - Gerar endereços de depósito
    • Blockchains suportadas: EVM (Ethereum, Polygon, Arbitrum, etc.), Solana, Bitcoin
    • Retorna um endereço de depósito único para a blockchain selecionada
  • POST /withdraw (Jan 2026) - Faça bridge de USDC.e para qualquer blockchain suportada
  • GET /supported-assets - Listar todos os ativos e blockchains suportados
  • GET /quote - Obter cotações de bridge cross-chain (taxas, tempo estimado)

Use a API Bridge quando um usuário precisar mover fundos para dentro ou fora do Polymarket sem sair do terminal.


Novos Tipos de Mercado

  • Mercados de criptomoedas de 5 minutos (Fev 2026) - Mercados de duração ultra-curta sobre movimentos de preço de BTC/ETH/SOL. Alimentados pelos dados crypto_prices do RTDS.
  • Mercados esportivos - Metadados esportivos dedicados via endpoint Gamma /sports com informações de times, cronogramas de partidas e critérios de resolução.

Recuperação de Erros

Erros da API (Gamma API)

Se a API Gamma retornar um erro ou estiver inacessível:

  • HTTP 429 (Limite de taxa)

[truncado para tradução]

Habilidades Relacionadas