PolyTerminal
É fácil confundir dois upgrades com nomes parecidos. O CLOB V2 mudou a exchange, o backend de ordens e o token de garantia. O Protocol V2 acrescentou uma segunda forma de manter posições de resultado. Este guia explica os dois com base na documentação da própria Polymarket, resume os detalhes de desenvolvedor e diz onde as páginas se calam ou se contradizem. Uma linha do tempo datada das entradas do changelog está em um post separado.
O que é o pUSD?
A documentação da Polymarket descreve o pUSD como o token de colateral de todas as negociações na Polymarket. Tecnicamente, ele é um token ERC-20 na Polygon lastreado em USDC. ERC-20 é um padrão de tokens, e a documentação chama o pUSD de wrapper que representa um direito sobre USDC. O contrato inteligente garante o lastro, e a página afirma que não há paridade algorítmica nem reserva fracionária. Um par completo de tokens Sim e Não em um mercado é lastreado por 1 pUSD de valor.
O pUSD pode ser transferido como qualquer outro token ERC-20, mas foi feito para funcionar dentro da Polymarket: a documentação diz que não há planos, por ora, de listá-lo em exchanges externas. Os Perps da Polymarket usam o mesmo token, já que a garantia dos Perps é pUSD (veja o guia de Perps).
Por que a Polymarket o introduziu?
A documentação dá um motivo curto: liquidação em USDC nativo, que ela descreve como um padrão mais eficiente em capital, mais escalável e mais alinhado com instituições à medida que a plataforma cresce. A garantia anterior ao pUSD era o USDC.e, a forma do USDC levada por bridge, e o pUSD a substituiu. As páginas não comparam os dois tokens nem dizem mais nada sobre a decisão.
Como obter pUSD?
Depende de como você usa a Polymarket.
- No polymarket.com. O frontend faz o wrap dos seus fundos automaticamente após uma aprovação única. Depois disso, você só vê um saldo e opera.
- Depositando. A bridge cuida da conversão: os ativos de outras redes são convertidos automaticamente em pUSD na Polygon. Você pode enviar USDC nativo ou USDC.e via bridge.
- Pelos contratos. A documentação cita dois grupos que fazem o wrap manualmente, os usuários avançados e os traders que usam só a API, que fazem o wrap de USDC.e em pUSD pelo contrato Collateral Onramp. Ela não descreve outras interfaces.
No caminho inverso, um saque faz o unwrap do pUSD pelo Collateral Offramp, e também é possível sacar o próprio pUSD, embora algumas exchanges não aceitam mais depósitos diretos de pUSD. Sobre taxas, a página de Fees diz que a Polymarket não cobra taxa para depositar ou sacar USDC, e a página de Withdraw diz que ela não cobra taxas de saque; um serviço que você use no caminho pode cobrar a sua própria taxa.
Que tipo de carteira uma conta usa?
A página de Wallets diz que a Deposit Wallet (carteira de depósito) é o padrão e que todas as carteiras de conta implantadas a partir de 4 de maio de 2026 usam uma, com as carteiras Proxy e Safe como tipos legados. O Polymarket 101 diz isso de forma mais restrita: os novos usuários da API usam carteiras de depósito, e as carteiras Safe e Proxy continuam com suporte para quem e para as integrações que já as usam. A página de Contracts acrescenta que o pUSD e as carteiras de conta da Polymarket funcionam com os dois sistemas de posições, que são tratados abaixo.
O que o CLOB V2 mudou?
O CLOB V2 é o upgrade que introduziu o pUSD. O changelog da Polymarket o descreve como um upgrade coordenado, feito de novos contratos de exchange, um backend de CLOB reconstruído e o pUSD como novo token de colateral. Ele entrou no ar em 28 de abril de 2026, por volta das 11:00 UTC, e a negociação ficou pausada por cerca de 1 hora. Para os traders, os efeitos visíveis foram estes:
- As ordens abertas foram apagadas, então tudo o que estava parado antes da virada precisou ser colocado de novo.
- As taxas são definidas pelo protocolo, no momento do casamento, em vez de fazerem parte da ordem assinada. O guia de taxas trata das taxas.
- A atribuição de builder agora passa por um campo opcional de builder code na ordem. O guia de migração diz que os builder codes permitem atribuição e divisão de receita para integradores.
O que é o Protocol V2?
O Protocol V2 é uma mudança diferente do CLOB V2, e as páginas de migração dele partem de integrações que já usam o pUSD e o formato de ordem do CTF Exchange V2. A documentação diz que ele introduz novos tokens de posição, além de novos contratos para negociação, operações de posição e resolução. Um detalhe de nomenclatura: a página de Contracts coloca o mesmo selo Poly v2 no token pUSD e nos seus contratos Onramp e Offramp que no PositionManager, enquanto o changelog e o guia de migração ligam o pUSD à entrada no ar do CLOB V2, que é a leitura que este guia segue.
O núcleo do Protocol V2 é um segundo registro para posições de resultado. Os mercados do Conditional Tokens Framework (CTF) guardam os saldos de Sim e Não no contrato Conditional Tokens. Os mercados do Protocol V2 os guardam em um contrato chamado PositionManager, que repassa cada operação a um módulo: o BinaryModule para um mercado simples de Sim/Não, o NegRiskModule para eventos com vários resultados e o CombinatorialModule para posições montadas a partir de um conjunto de pernas. As posições combinatórias, que juntam vários resultados existentes em um novo par Sim e Não, usam o Protocol V2 e não o Conditional Tokens Framework. As ordens das posições V2 são executadas e finalizadas por um contrato de exchange separado, o ExchangeV3, e os splits, merges e resgates passam por um contrato chamado Router.
O Protocol V2 também chega à resolução. O Polymarket 101 diz que os mercados V2 também podem usar outros mecanismos de resolução. A página de Contracts mostra o caminho: os resultados vão dos módulos reporter, passando por um OracleAggregator, ao módulo que é dono da condição, com módulos reporter chamados OO, Chainlink e EOA. Os dados de resolução citam um reporter para cada condição resolvida: UMA_OO, CHAINLINK ou EOA. As páginas não explicam as siglas "OO" e "EOA" nem dizem quais mercados usam qual reporter. O guia de resolução trata do caminho da UMA por completo.
Como os dois sistemas de posições se relacionam?
| Sistema de posições | Contrato que guarda os saldos | Lógica de mercado | Identificador do resultado |
|---|---|---|---|
| Polymarket Protocol V2 | PositionManager | BinaryModule, NegRiskModule ou CombinatorialModule | Position ID |
| CTF (Conditional Tokens) | Conditional Tokens | A lógica CTF padrão ou o Neg Risk Adapter | CTF token ID |
Os dois sistemas de posições da Polymarket. Fonte: docs.polymarket.com/trading/positions/how-positions-work, conferido .
Os dois sistemas guardam os resultados Sim e Não como tokens ERC-1155 (o padrão que a página 101 cita para as cotas de resultado), e a documentação diz que esses saldos significam a mesma coisa economicamente para um trader. Dividir pUSD em um par Sim e Não, juntar o par de novo e resgatar após a resolução existem nos dois, por contratos diferentes. A página How Positions Work avisa que um CTF token ID não deve ser enviado ao PositionManager, nem um Position ID ao Conditional Tokens; ela diz que a descoberta de mercados fornece os identificadores de que cada fluxo precisa.
O que acontece com o que você já tem? A visão geral diz que as posições CTF existentes não são convertidas, e a página de migração de contratos acrescenta que atualizar uma integração não converte os saldos CTF existentes. A página de Contracts também descreve um caminho de migração das posições CTF para o PositionManager, mas a Polymarket precisa registrar antes a condição ou o evento, e as páginas não dizem quem pode usá-lo nem quando. Para quem usa o app e o site da Polymarket, a visão geral diz que nenhuma migração técnica é necessária, além de concluir os pedidos de aprovação que aparecerem.
O que mudou para os traders e o que não mudou
O que mudou
- A garantia é o pUSD em vez do USDC.e, então saldos, custos de ordens e pagamentos são em pUSD.
- Alguns mercados mantêm as posições no registro do Protocol V2, e o app da Polymarket pode mostrar pedidos de aprovação.
O que continua igual
- A página do pUSD da Polymarket diz assim: no dia a dia, nada muda. Você continua depositando, conferindo o saldo, operando e sacando.
- Uma cota vencedora continua sendo resgatada por $1.00 cada e uma cota perdedora continua sem valor, qualquer que seja o sistema que a guarda.
- A página Prices & Orderbook diz que o livro de ordens é compartilhado entre os mercados, enquanto a rota de liquidação depende de qual sistema guarda os tokens.
- Para integrações que já usam o pUSD, a visão geral diz que, no Protocol V2, o colateral, as carteiras, as credenciais da CLOB e os endpoints não mudam.
O que conferir na página de um mercado
- As regras de resolução. Elas definem como o mercado resolve, e alguns mercados podem usar mecanismos diferentes da UMA. Veja o guia de resolução.
- A unidade. Saldos, custos de ordens e pagamentos são em pUSD, não em USDC.e, e uma ordem limitada é colocada com um preço e um número de cotas.
- Os pedidos de aprovação. A visão geral orienta quem usa o app e o site da Polymarket a concluir qualquer pedido de aprovação que apareça. As páginas não dizem o que esses pedidos aprovam.
- A versão, se você lê dados. Os dados de mercado da Gamma API trazem uma versão: "v1" para os mercados CTF e "v2" para os mercados do Protocol V2. O conselho da documentação é: leia o campo version do mercado, pois a presença de um campo de ID não diz isso. As páginas usadas para este guia não dizem que o app da Polymarket a exibe.
- Os avisos oficiais. O changelog e a página de status anunciam mudanças e incidentes; o post da linha do tempo lista as entradas datadas do changelog.
Para desenvolvedores
Os desenvolvedores tiveram mais a fazer. No CLOB V2, a produção deixou de dar suporte a aceitar os SDKs V1 legados e as ordens assinadas na V1, e a estrutura da ordem e o domínio de assinatura mudaram; o guia Migrating to CLOB V2 traz os detalhes. No Protocol V2, a Polymarket publica páginas de migração para integrações de SDK, de API e de contratos inteligentes, todas acessadas pela visão geral. Em resumo, você escolhe os identificadores pela versão do mercado, concede aprovações novas porque as permissões CTF existentes não são transferidas para a V2, assina as ordens V2 na exchange V2 e mantém o suporte a CTF para os mercados CTF. Este guia para aqui de propósito.
FAQ
O pUSD é a mesma coisa que o USDC?
Não. O pUSD é um token próprio: um ERC-20 na Polygon que a Polymarket descreve como lastreado em USDC, com o lastro garantido pelo contrato inteligente. A documentação o chama de wrapper que representa um direito sobre USDC, feito para funcionar dentro da Polymarket, e diz que não há planos, por ora, de listá-lo em exchanges externas. Qual forma de USDC fica na reserva não é informado (veja a nota acima).
Preciso converter meu dinheiro em pUSD por conta própria?
Não no polymarket.com, onde o frontend cuida do wrap após uma aprovação única, e não quando você deposita pela bridge, que converte automaticamente. A documentação cita dois grupos que fazem o wrap manualmente: usuários avançados e traders que usam só a API. Ela não descreve outras interfaces.
O que acontece com as minhas posições antigas no Protocol V2?
A visão geral diz que as posições CTF existentes não são convertidas. A página de Contracts descreve uma migração para condições registradas, mas as páginas não dizem quem pode usá-la nem quando. A documentação diz que os saldos nos dois sistemas significam a mesma coisa economicamente para um trader.
Quando o Protocol V2 começou?
As páginas usadas para este guia não dão uma data para ele. Elas datam o upgrade CLOB V2 que introduziu o pUSD, que entrou no ar em 28 de abril de 2026. O post da linha do tempo lista as entradas datadas do changelog e o que continua sem data.
Fontes e verificações
- Polymarket USD
- Migrating to CLOB V2
- Migrate to Polymarket Protocol V2
- Polymarket Protocol V2 SDK Migration
- Polymarket Protocol V2 API Migration
- Polymarket Protocol V2 Contract Migration
- Positions & Tokens
- How Positions Work
- Combinatorial Positions
- Prices & Orderbook
- Onchain Position Data
- Market Details
- Place Orders
- Contracts
- Wallets and Authentication
- Deposit
- Withdraw
- Fees
- Perps concepts
- Polymarket 101
- Predictions changelog
Cada regra citada neste artigo vem do registro abaixo. Cada linha indica a página oficial e o dia em que foi comparada com o texto.
Todas as 52 regras usadas neste artigo
| Regra | Valor | Fonte oficial | Conferido |
|---|---|---|---|
| O que é o pUSD | o token de colateral de todas as negociações na Polymarket | docs.polymarket.com/ | |
| Data de entrada no ar do CLOB V2 | 28 de abril de 2026 | docs.polymarket.com/ | |
| Posições CTF existentes no Protocol V2 | não são convertidas | docs.polymarket.com/ | |
| O que os usuários do app e do site da Polymarket precisam fazer pelo Protocol V2 | nenhuma migração técnica é necessária, além de concluir os pedidos de aprovação que aparecerem | docs.polymarket.com/ | |
| Padrão de token e rede do pUSD | um token ERC-20 na Polygon lastreado em USDC | docs.polymarket.com/ | |
| Como funciona o lastro do pUSD | sem paridade algorítmica e sem reserva fracionária | docs.polymarket.com/ | |
| Valor que lastreia um conjunto completo Sim e Não | 1 pUSD | docs.polymarket.com/ | |
| Listagem externa do pUSD | sem planos, por ora, de listá-lo em exchanges externas | docs.polymarket.com/ | |
| Colateral dos Perps | pUSD | docs.polymarket.com/ | |
| Motivo do pUSD segundo a Polymarket | liquidação em USDC nativo | docs.polymarket.com/ | |
| Como os usuários do polymarket.com obtêm pUSD | faz o wrap dos seus fundos automaticamente após uma aprovação única | docs.polymarket.com/ | |
| O que a bridge faz com um depósito | os ativos de outras redes são convertidos automaticamente em pUSD na Polygon | docs.polymarket.com/ | |
| Ativos de origem aceitos em um depósito | USDC nativo ou USDC.e via bridge | docs.polymarket.com/ | |
| Como os traders que só usam a API obtêm pUSD | façam o wrap de USDC.e em pUSD pelo contrato Collateral Onramp | docs.polymarket.com/ | |
| Exchanges e depósitos diretos de pUSD | algumas exchanges não aceitam mais depósitos diretos de pUSD | docs.polymarket.com/ | |
| Taxa da Polymarket para depositar ou sacar | sem taxa | docs.polymarket.com/ | |
| Taxa da Polymarket em saques | não cobra taxas de saque | docs.polymarket.com/ | |
| Wrap enquanto um ativo está pausado | falha se o admin pausou o USDC.e | docs.polymarket.com/ | |
| Unwrap enquanto um ativo está pausado | usa o mesmo mecanismo de pausa | docs.polymarket.com/ | |
| Qual ativo o Collateral Onramp converte | precisa ser USDC.e | docs.polymarket.com/ | |
| O que a página de Depósito diz sobre USDC nativo e USDC.e | o USDC nativo e o USDC.e via bridge são ambos convertidos em pUSD pelo Collateral Onramp | docs.polymarket.com/ | |
| O que a página de Saque diz sobre o unwrap | passa por unwrap para USDC pelo Collateral Offramp e depois é trocado por USDC nativo | docs.polymarket.com/ | |
| Data a partir da qual as novas carteiras de conta são Deposit Wallets | 4 de maio de 2026 | docs.polymarket.com/ | |
| Quais contas usam carteiras de depósito, nas palavras do Polymarket 101 | usam carteiras de depósito | docs.polymarket.com/ | |
| Situação das carteiras Safe e Proxy | continuam com suporte para quem e para as integrações que já as usam | docs.polymarket.com/ | |
| Quais sistemas de posições o pUSD atende | funciona com os dois sistemas de posições | docs.polymarket.com/ | |
| Do que consistiu o upgrade CLOB V2 | novos contratos de exchange, um backend de CLOB reconstruído e o pUSD como novo token de colateral | docs.polymarket.com/ | |
| Horário da virada para o CLOB V2 | por volta das 11:00 UTC | docs.polymarket.com/ | |
| Pausa na negociação durante a virada para o CLOB V2 | cerca de 1 hora | docs.polymarket.com/ | |
| Ordens abertas na virada para o CLOB V2 | foram apagadas | docs.polymarket.com/ | |
| Quando as taxas são definidas no CLOB V2 | pelo protocolo, no momento do casamento | docs.polymarket.com/ | |
| Atribuição de builder no CLOB V2 | um campo opcional de builder code na ordem | docs.polymarket.com/ | |
| Ponto de partida presumido pelas páginas de migração do Protocol V2 | já usar o pUSD e o formato de ordem do CTF Exchange V2 | docs.polymarket.com/ | |
| O que o Protocol V2 introduz | novos tokens de posição, além de novos contratos para negociação, operações de posição e resolução | docs.polymarket.com/ | |
| Selo Poly v2 na página Contracts | coloca o mesmo selo Poly v2 no token pUSD e nos seus contratos Onramp e Offramp que no PositionManager | docs.polymarket.com/ | |
| Qual sistema as posições combinatórias usam | usam o Protocol V2 e não o Conditional Tokens Framework | docs.polymarket.com/ | |
| Mecanismos de resolução dos mercados do Protocol V2 | também podem usar outros mecanismos de resolução | docs.polymarket.com/ | |
| Como os resultados chegam a um mercado do Protocol V2 | os resultados vão dos módulos reporter, passando por um OracleAggregator, ao módulo que é dono da condição | docs.polymarket.com/ | |
| Famílias de reporter citadas em uma linha de resolução | UMA_OO, CHAINLINK ou EOA | docs.polymarket.com/ | |
| Significado econômico dos saldos nos dois sistemas de posições | significam a mesma coisa economicamente para um trader | docs.polymarket.com/ | |
| CTF token IDs e Position IDs | um CTF token ID não deve ser enviado ao PositionManager, nem um Position ID ao Conditional Tokens | docs.polymarket.com/ | |
| Atualizar uma integração e os saldos CTF | atualizar uma integração não converte os saldos CTF existentes | docs.polymarket.com/ | |
| Quando um detentor de CTF pode migrar para o PositionManager | a Polymarket precisa registrar antes a condição ou o evento | docs.polymarket.com/ | |
| O que o pUSD muda no uso diário | no dia a dia, nada muda | docs.polymarket.com/ | |
| Valor de resgate de um token vencedor | $1.00 cada | docs.polymarket.com/ | |
| O livro de ordens entre os dois sistemas de posições | é compartilhado entre os mercados, enquanto a rota de liquidação depende de qual sistema guarda os tokens | docs.polymarket.com/ | |
| O que continua igual para integrações que já usam o pUSD | o colateral, as carteiras, as credenciais da CLOB e os endpoints não mudam | docs.polymarket.com/ | |
| Como uma ordem limite é dimensionada | uma ordem limite é colocada com um preço e um número de shares | docs.polymarket.com/ | |
| Como saber qual sistema de posições um mercado usa | leia o campo version do mercado, pois a presença de um campo de ID não diz isso | docs.polymarket.com/ | |
| O que a produção deixou de aceitar após a virada para o CLOB V2 | os SDKs V1 legados e as ordens assinadas na V1 | docs.polymarket.com/ | |
| Permissões do CTF e aprovações do Protocol V2 | as permissões CTF existentes não são transferidas para a V2 | docs.polymarket.com/ | |
| Os dois sistemas de posições da Polymarket | Position systems | docs.polymarket.com/ |
Continue lendo
Básico · 10 min
Como a Polymarket funciona: mercados e shares
O básico da Polymarket para traders: eventos e mercados, shares Sim e Não, preços como probabilidades, colateral pUSD, livro de ordens, resolução e resgate.
Básico · 11 min
Como os mercados da Polymarket são resolvidos
Como um mercado da Polymarket é resolvido pelo oráculo da UMA: as regras que decidem, propostas e bonds, contestações, a votação e o que os vencedores resgatam.
Básico · 9 min
Taxas da Polymarket explicadas
Taxas dos mercados de previsão da Polymarket: fórmula da taxa de taker, alíquotas por categoria, pico em 50 centavos, rebates de maker, builder fees e 2026.
19 de outubro de 2026 · 6 min
CLOB V2 e pUSD da Polymarket: linha do tempo
Linha do tempo datada da atualização CLOB V2 e pUSD da Polymarket, o que a documentação oficial diz sobre o Protocol V2 e o que ela deixa sem data.
A PolyTerminal é uma interface independente para a Polymarket e não é operada nem endossada pela Polymarket. As ordens enviadas pela PolyTerminal levam o builder code da PolyTerminal na Polymarket, e a PolyTerminal pode cobrar um builder fee além das taxas da própria Polymarket. Esta página é educativa e não é recomendação de investimento. As regras foram comparadas com a documentação oficial em 19 de outubro de 2026; confira a fonte antes de agir com base em um número.