Resumo
Polymarket CLI é uma ferramenta de linha de comando baseada em Rust que permite navegar em mercados de previsão, fazer pedidos, gerenciar posições e interagir com contratos on-chain diretamente do seu terminal. Instale via Homebrew ou script shell, navegue nos mercados sem carteira e negocie usando a saída JSON para automação. Requer uma chave privada para operações de negociação. Suporta formatos de saída de tabela e JSON para uso legível por humanos e programático.
Introdução
Os mercados de previsão surgiram como ferramentas poderosas para prever eventos do mundo real, desde resultados de eleições até movimentos de preços de criptomoedas. Polymarket, construído na Polygon, oferece um dos mercados de previsão mais líquidos, com milhões em volume de negociação. Embora a interface web seja intuitiva, os desenvolvedores frequentemente desejam acesso programático para automação, script e construção de bots de negociação personalizados.
É aí que entra o Polymarket CLI. Esta ferramenta de linha de comando baseada em Rust fornece acesso completo ao ecossistema Polymarket a partir do seu terminal. Quer você queira navegar nos mercados, analisar livros de ordens ou executar negociações automaticamente, o Polymarket CLI oferece uma interface robusta que se integra perfeitamente com scripts shell e fluxos de trabalho de automação.
O que é o Polymarket?
Polymarket é uma plataforma de mercado de previsão descentralizada construída na blockchain Polygon. Ela permite que os usuários negociem os resultados de eventos do mundo real usando a stablecoin USDC. Os mercados são estruturados como perguntas de sim/não, com os preços representando a probabilidade de um resultado (por exemplo, 52¢ significa 52% de probabilidade).
Principais recursos do Polymarket incluem:
- Negociação descentralizada: Construído na Polygon para transações rápidas e de baixo custo
- Mercados em tempo real: Milhares de mercados cobrindo política, cripto, esportes e muito mais
- Modelo de livro de ordens: Livro de ordens de limite central (CLOB) para descoberta de preços
- Tokens condicionais: Tokens ERC-1155 representando cotas de resultados
- Programa de recompensas: Traders podem ganhar recompensas com base no volume de negociação
O Polymarket CLI se conecta a esses mercados por meio de uma combinação de APIs off-chain (para leitura de dados de mercado e realização de pedidos) e contratos on-chain (para operações de token como divisão, fusão e resgate).
Instalando o Polymarket CLI
Polymarket CLI suporta múltiplos métodos de instalação. Escolha aquele que melhor se adapta ao seu ambiente.
Opção 1: Homebrew (macOS / Linux)
O método de instalação mais fácil usa o Homebrew:
# Adicione o tap do Polymarket
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Instale o polymarket
brew install polymarket
Opção 2: Script Shell (Linux/macOS)
Para uma instalação rápida em uma linha:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Isso baixa o binário mais recente e o instala no seu PATH.
Opção 3: Construir a partir do Código-Fonte (Todas as Plataformas)
Se você tiver o Rust instalado, pode construir a partir do código-fonte:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Verificando a Instalação
Verifique se a instalação foi bem-sucedida:
polymarket --version
polymarket --help
Você deverá ver informações de versão e uma mensagem de ajuda com os comandos disponíveis.
Início Rápido: Navegue pelos Mercados Sem uma Carteira
Uma das melhores funcionalidades do Polymarket CLI é que você não precisa de uma carteira para navegar nos mercados. Isso o torna perfeito para pesquisa e monitoramento antes de comprometer fundos.
Navegar por Mercados Recentes
# Liste os 5 mercados mais recentes
polymarket markets list --limit 5
Expected output:
Pesquisar por Mercados Específicos
# Pesquisar mercados relacionados ao Bitcoin
polymarket markets search "bitcoin" --limit 5
Filtrar por Status e Volume
# Listar mercados fechados
polymarket markets list --closed true --limit 20
Navegar por Eventos
Eventos agrupam mercados relacionados. Por exemplo, o evento "Eleição de 2024" contém múltiplos mercados sobre diferentes aspectos da eleição.
# Listar eventos recentes
polymarket events list --limit 10
# Filtrar eventos por tag
polymarket events list --tag politics --active true
# Obter um evento específico
polymarket events get 500
Configuração da Carteira
Enquanto a navegação não exige uma carteira, a negociação sim. Veja como configurar sua carteira.
Criando uma Nova Carteira
# Crie uma nova carteira (gera chave aleatória, salva na configuração)
polymarket wallet create
Isso gera uma nova chave privada e a armazena no seu arquivo de configuração em ~/.config/polymarket/config.json.
Importando uma Carteira Existente
Se você já possui uma carteira com fundos:
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Localização do Arquivo de Configuração
O arquivo de configuração é armazenado em ~/.config/polymarket/config.json e tem esta aparência:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Métodos de Configuração da Carteira
Você pode fornecer sua chave privada de três maneiras (verificadas nesta ordem):
- Flag CLI:
--private-key 0xabc... - Variável de ambiente:
POLYMARKET_PRIVATE_KEY=0xabc... - Arquivo de configuração:
~/.config/polymarket/config.json
Tipos de Assinatura
Polymarket suporta três tipos de assinatura:
| Tipo | Descrição |
|---|---|
proxy (padrão) | Usa o sistema de carteira proxy da Polymarket |
eoa | Assina diretamente com sua chave |
gnosis-safe | Para carteiras multisig |
Sobrescreva por comando com --signature-type eoa.
Verificando o Status da Carteira
# Mostrar informações completas da carteira
polymarket wallet show
# Exibir apenas o endereço
polymarket wallet address
Aprovações de Contrato
Antes de negociar, você precisa aprovar os contratos do Polymarket:
# Verificar aprovações atuais (somente leitura)
polymarket approve check
# Aprovar todos os contratos (envia 6 transações on-chain)
polymarket approve set
Nota: A aprovação de contratos requer MATIC para taxas de gás na Polygon.
Explorando Mercados e Eventos
Vamos nos aprofundar nos comandos de exploração de mercado.
Comandos de Mercado
# Obter informações detalhadas do mercado
polymarket markets get will-bitcoin-hit-100k
# Obter tags para um mercado
polymarket markets tags MARKET_ID
# Listar mercados com vários filtros
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Comandos de Eventos
# Listar eventos com filtros
polymarket events list --active true --limit 10
# Obter tags de evento
polymarket events tags EVENT_ID
# Séries (eventos recorrentes como mercados semanais)
polymarket series list --limit 10
polymarket series get SERIES_ID
Comandos de Tags
# Listar todas as tags
polymarket tags list
# Obter informações de tag específica
polymarket tags get politics
# Encontrar tags relacionadas
polymarket tags related politics
Comandos CLOB (Livro de Ordens)
Verifique preços e livros de ordens sem uma carteira:
# Verificar saúde da API
polymarket clob ok
# Obter preço para um token
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Obter spread
polymarket clob spread TOKEN_ID
# Obter livro de ordens
polymarket clob book TOKEN_ID
# Último preço de negociação
polymarket clob last-trade TOKEN_ID
# Histórico de preços
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Opções de intervalo: 1m, 1h, 6h, 1d, 1w, max
Negociando no Polymarket
Agora para a parte emocionante — fazer negociações. Estes comandos exigem uma carteira configurada.
Fazendo Pedidos
# Fazer uma ordem limite (comprar 10 cotas a $0.50)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Fazer uma ordem a mercado (comprar $5 em valor)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Publicar múltiplas ordens de uma vez
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Tipos de ordem: GTC (Boa Até Cancelar - padrão), FOK (Preencher ou Cancelar), GTD (Boa Até Data), FAK (Preencher e Cancelar)
Adicione --post-only para ordens limite que apenas adicionam liquidez.
Gerenciando Pedidos
# Ver seus pedidos
polymarket clob orders
# Obter detalhes de pedido específico
polymarket clob order ORDER_ID
# Cancelar um único pedido
polymarket clob cancel ORDER_ID
# Cancelar múltiplos pedidos
polymarket clob cancel-orders "ORDER1,ORDER2"
# Cancelar todos os pedidos para um mercado
polymarket clob cancel-market --market CONDITION_ID
# Cancelar todos os pedidos
polymarket clob cancel-all
Verificando Saldos e Negociações
# Verificar saldo de USDC
polymarket clob balance --asset-type collateral
# Verificar saldo de token condicional
polymarket clob balance --asset-type conditional --token TOKEN_ID
# Ver suas negociações
polymarket clob trades
# Atualizar saldo (atualizar da cadeia)
polymarket clob update-balance --asset-type collateral
Recompensas e Chaves de API
# Verificar recompensas
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Verificar se os pedidos estão pontuando recompensas
polymarket clob order-scoring ORDER_ID
# Criar chave de API para acesso programático
polymarket clob create-api-key
# Listar suas chaves de API
polymarket clob api-keys
Operações On-Chain
O Polymarket CLI também suporta interação direta com contratos on-chain.
Operações CTF (Conditional Token Framework)
# Dividir $10 USDC em tokens SIM/NÃO
polymarket ctf split --condition CONDITION_ID --amount 10
# Fundir tokens de volta para USDC
polymarket ctf merge --condition CONDITION_ID --amount 10
# Resgatar tokens vencedores após a resolução
polymarket ctf redeem --condition CONDITION_ID
Nota: Operações on-chain exigem MATIC para gás na Polygon.
Operações de Bridge
Depositar ativos de outras cadeias:
# Obter endereços de depósito para EVM, Solana, Bitcoin
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Listar cadeias e tokens suportados
polymarket bridge supported-assets
# Verificar status do depósito
polymarket bridge status DEPOSIT_ADDRESS
Dados do Portfólio
# Ver posições atuais
polymarket data positions YOUR_WALLET_ADDRESS
# Ver posições fechadas
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Valor total do portfólio
polymarket data value YOUR_WALLET_ADDRESS
# Histórico de negociações
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Usando Saída JSON para Scripts
Uma das funcionalidades mais poderosas do Polymarket CLI é a saída JSON, tornando-o perfeito para scripting e automação.
Saída JSON Básica
# Obter mercados como JSON
polymarket -o json markets list --limit 10
Output:
[
{"id": "12345", "question": "O BTC atingirá $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "O ETH ultrapassará o BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Usando com jq
# Extrair apenas as perguntas
polymarket -o json markets list --limit 100 | jq '.[].question'
# Obter dados de preço específicos
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Filtrar mercados por volume
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Tratamento de Erros em Scripts
#!/bin/bash
# Exemplo: Verificar saldo com tratamento de erros
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Falha ao buscar saldo"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Seu saldo: $balance USDC"
Automatizando o Monitoramento de Mercado
Crie um monitor de mercado simples:
#!/bin/bash
# monitor-market.sh - Monitorar o preço de um mercado específico
TOKEN_ID=$1
INTERVAL=${2:-60} # Padrão 60 segundos
while true; do
clear
echo "Monitorando mercado: $(date)"
polymarket clob price $TOKEN_ID --side buy
polymarket clob price $TOKEN_ID --side sell
echo ""
polymarket clob book $TOKEN_ID | head -20
sleep $INTERVAL
done
Execute com: ./monitor-market.sh TOKEN_ID 30
Testando a API Polymarket com Apidog
Ao construir sistemas de negociação automatizados ou integrar o Polymarket em suas aplicações, o teste de API é essencial. Apidog oferece uma plataforma poderosa e completa de desenvolvimento de API que torna o teste de APIs de mercado de previsão direto e eficiente.
Por Que Usar o Apidog para Integração com Polymarket?
Quer você esteja construindo um bot de negociação, um painel de análise de mercado ou integrando dados do Polymarket em sua aplicação, o Apidog oferece várias vantagens:
- Cliente API Visual: Envie requisições e inspecione respostas sem escrever código
- Testes Automatizados: Crie suítes de teste para verificar sua lógica de negociação
- Variáveis de Ambiente: Gerencie endpoints de API e credenciais em ambientes de desenvolvimento/staging/produção
- Colaboração: Compartilhe definições de API com sua equipe
Modo Shell Interativo
Para exploração interativa, use o shell integrado:
polymarket shell
Isso abre um REPL interativo:
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
O shell suporta histórico de comandos, facilitando a experimentação com diferentes comandos.
Fluxos de Trabalho Comuns
Fluxo de Trabalho 1: Pesquisa e Negociação
# Passo 1: Encontre mercados interessantes
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Passo 2: Verifique o livro de ordens e os preços
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Passo 3: Verifique seu saldo
polymarket clob balance --asset-type collateral
# Passo 4: Faça uma negociação
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
Fluxo de Trabalho 2: Gerenciamento de Portfólio
# Ver todas as posições
polymarket data positions YOUR_ADDRESS
# Verificar valor total
polymarket data value YOUR_ADDRESS
# Ver histórico de negociação
polymarket data trades YOUR_ADDRESS --limit 50
# Verificar ordens abertas
polymarket clob orders
Fluxo de Trabalho 3: Bot de Negociação Programático
#!/bin/bash
# Bot simples: compra quando o preço cai abaixo do limite
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Obter preço atual
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# Converter para decimal
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Preço ($PRICE_DECIMAL) abaixo do limite ($THRESHOLD) - comprando"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Preço ($PRICE_DECIMAL) acima do limite - mantendo"
fi
Considerações de Segurança
Ao usar o Polymarket CLI, mantenha estas melhores práticas de segurança em mente:
Segurança da Chave Privada
- Nunca envie sua chave privada para controle de versão
- Use o arquivo de configuração em vez de variáveis de ambiente em ambientes compartilhados
- Considere a integração com carteira de hardware para grandes fundos
- Use uma carteira separada para negociação via CLI (não sua carteira principal)
Verificação de Transações
- Sempre verifique os detalhes da transação antes de confirmar
- Comece com pequenas quantias para testar sua configuração
- Mantenha seu saldo de MATIC suficiente para as taxas de gás
Gerenciamento de Chaves de API
# Crie chaves de API dedicadas para scripts
polymarket clob create-api-key
# Listar e gerenciar chaves
polymarket clob api-keys
# Excluir chaves comprometidas
polymarket clob delete-api-key
Segurança de Rede
- Use o CLI via HTTPS (padrão)
- Seja cauteloso ao usar chaves privadas em ambientes de nuvem
- Considere usar uma VPN ao negociar em redes públicas
Conclusão
Polymarket CLI é uma ferramenta poderosa para desenvolvedores que desejam interagir com mercados de previsão programaticamente. Seja você um trader buscando automatizar estratégias, um pesquisador analisando dados de mercado ou um desenvolvedor construindo bots de negociação, o CLI oferece uma interface robusta para o ecossistema Polymarket.
Principais pontos desta guia:
- Instale via Homebrew ou script shell para configuração rápida
- Navegue pelos mercados sem uma carteira para pesquisa
- Configure sua carteira corretamente antes de negociar
- Use a saída JSON para scripting e automação
- Sempre priorize a segurança ao lidar com chaves privadas
- Comece com pequenas negociações para testar sua configuração
- Use o Apidog para testar e validar suas integrações de API do Polymarket
Para casos de uso mais avançados, considere combinar o Polymarket CLI com outras ferramentas como cron para tarefas agendadas, jq para processamento de dados, ou bots personalizados construídos em Python ou Node.js. Ao construir sua integração de negociação, use o Apidog para testar minuciosamente todos os endpoints da API antes de entrar em produção.
Experimente o Apidog gratuitamente para otimizar seu fluxo de trabalho de teste de API e construir confiança em suas integrações Polymarket.
Perguntas Frequentes
O Polymarket CLI é seguro para usar?
O Polymarket CLI é um software experimental. Use com cautela e nunca utilize com grandes quantias de fundos. Sempre verifique as transações antes de confirmar. O projeto é de código aberto, então você pode revisar o código por conta própria.
Preciso de uma carteira para navegar nos mercados?
Não. A maioria dos comandos (mercados, eventos, preços CLOB, livros de ordens) funciona sem uma carteira. Você só precisa de uma carteira para fazer pedidos, verificar saldos e realizar operações on-chain.
Quais cadeias o Polymarket suporta?
Polymarket é construído na Polygon (ID de cadeia 137). O CLI lida tanto com operações on-chain (exigindo MATIC para gás) quanto com a colocação de ordens off-chain.
Posso usar o Polymarket CLI para negociação automatizada?
Sim. O formato de saída JSON o torna ideal para scripting. Você pode construir bots de negociação automatizados usando scripts shell, Python ou qualquer linguagem que possa executar comandos CLI e analisar JSON.
Como obtenho ajuda com o Polymarket CLI?
Verifique o repositório oficial do GitHub para documentação e rastreamento de problemas.
O Polymarket CLI suporta testnet?
A versão atual funciona com a implantação principal do Polymarket. Para suporte a testnet, verifique o repositório do GitHub para as informações mais recentes.
Qual a diferença entre os tipos de assinatura proxy e eoa?
proxy (padrão) usa o sistema de carteira proxy do Polymarket, o que pode reduzir os custos de gás. eoa assina diretamente com sua chave privada. Para a maioria dos usuários, o tipo proxy padrão é recomendado.
Como atualizo o Polymarket CLI para a versão mais recente?
Execute polymarket upgrade para verificar e instalar atualizações. Para instalações via Homebrew, use brew update && brew upgrade polymarket.
Posso usar o Apidog para testar chamadas de API do Polymarket?
Sim. Apidog é uma excelente ferramenta para testar APIs de mercados de previsão. Crie um novo projeto no Apidog, adicione seus endpoints Polymarket e use o cliente visual para enviar requisições e inspecionar respostas. As variáveis de ambiente do Apidog facilitam o gerenciamento de diferentes credenciais de API, e você pode criar cenários de teste automatizados para verificar se sua lógica de negociação funciona corretamente.