Atividade de carteiras
Monitore endereços de carteiras para receber entradas e saídas de moeda nativa e tokens.
API Webhook de blockchain para atividade de carteiras e transferências de tokens
Webhooks de endereço enviam transferências de carteiras monitoradas e logs de contratos correspondentes ao seu receptor HTTPS; verifique assinaturas, deduplique eventos e trate lacunas antes de creditar um pagamento.
Eventos anteriores ao bloco de ativação de um endereço exigem uma busca histórica separada; replay não os recupera. Transferências nativas internas não estão incluídas. As confirmações devem respeitar o intervalo de cada rede em GET /v1/push/chains e contam blocos, não rótulos safe ou finalized.
Atividade de endereços entregue ao seu endpoint
native.transfer entrega transferências de moeda nativa em transações de nível superior; token.transfer entrega transferências ERC-20, ERC-721 e ERC-1155. log entrega outros logs cujo contrato emissor ou topics[1]–topics[3] contêm um endereço monitorado.
GET /v1/push/chains retorna as redes atualmente compatíveis e seus limites de confirmação. Consulte com sua API key antes de escolher as redes de uma inscrição.
Uma inscrição cobre várias redes com uma URL de recebimento. Desenvolvedores e AI Agents têm as mesmas opções de capacidade e preços.
- Autoatendimento
Até 1,000,000 endereços por inscrição. Disponível ao se cadastrar.
Tarifas padrão por uso
- Empresarial
10,000,000 / 100,000,000 endereços por inscrição.
Fale conosco para ativar
As duas opções usam as mesmas tarifas por endereço-dia e evento entregue.
Use a atividade de carteiras e contratos
Pagamentos com stablecoins
Receba transferências ERC-20 de USDT / USDC e valide o contrato do token, destinatário e valor inteiro antes de creditar o pagamento.
Eventos de contratos
Monitore um contrato para receber seus logs, ou receba logs com um endereço monitorado em topics[1]–topics[3].
Transferências NFT
Processe transferências ERC-721 e ERC-1155 com token_id e, nas transferências em lote, batch_index.
Verifique, confirme e recupere eventos
- Verifique a assinatura HMAC-SHA256 sobre `webhook-id.webhook-timestamp.raw-body` com o segredo da inscrição antes de processar os eventos; use o corpo original da requisição e não faça parse do JSON previamente.
- A entrega ocorre pelo menos uma vez. Elimine duplicatas pelo id do evento e retorne 2xx após persistir o resultado do processamento. Entregas com falha são repetidas enquanto a inscrição está online e os eventos estão no período de retenção.
- Configure confirmations por rede dentro dos limites de GET /v1/push/chains. chain.reorg informa blocos substituídos: marque os eventos antigos por ref, mantenha os eventos canônicos reenviados automaticamente e elimine duplicatas por id.
- Replay reenvia eventos correspondentes armazenados dentro do intervalo permitido. Não recupera atividade anterior à inclusão de um endereço ou rede na inscrição.
Preços
A tabela mostra os pesos CU e a cota gratuita de endereços de GET /v1/plans. Eventos de dados são cobrados por entrega; novas tentativas automáticas e eventos de controle são gratuitos. Entregas por replay são cobradas pela tarifa do evento.
Notificações webhook
Pesos CU de GET /v1/plans. Tentativas automáticas são gratuitas.
Endereços gratuitos por conta e dia UTC: 1000
A franquia de endereços gratuitos por conta e dia UTC é compartilhada por todos os grupos de assinatura, independentemente do plano. Para cada grupo, conta-se o número máximo de endereços enquanto esteve online naquele dia; a franquia é distribuída em ordem crescente de ID do grupo. O mesmo endereço em dois grupos conta duas vezes; o número de chains de um grupo não multiplica sua quantidade de endereços. Um grupo offline ou excluído durante todo o dia não contribui para a contagem. Para cada grupo, a quantidade restante após descontar sua parte da franquia é multiplicada pelo peso CU `push.address_day` em `method_weights`. A franquia configurada atualmente vem da mesma política de preços usada na cobrança por endereço-dia; não é um limite de capacidade da conta nem uma franquia separada por grupo.
| Método | Unidade de cobrança | CU |
|---|---|---|
| push.address_day | Dia de endereço faturável | 33 |
| push.history | Consulta de histórico bem-sucedida | 25 |
| push.log | Evento de dados entregue | 150 |
| push.native_transfer | Evento de dados entregue | 150 |
| push.token_transfer | Evento de dados entregue | 150 |