Visão geral da Developer API

O que é a Developer API

A Cognivo Developer API permite que você chame, a partir do seu próprio código, a mesma inteligência on-chain que alimenta o Cognivo Chat, o dApp e o bot do Telegram. Você cria um projeto, cria uma chave de API e envia requisições por HTTPS comum.

1. A área Desenvolvedores é onde você cria projetos e gerencia suas chaves de API da Cognivo.
2. Selecione Fazer login para abrir o portal do desenvolvedor. Suas chaves permanecem privadas da sua conta.

A página Desenvolvedores no dApp da Cognivo.Ampliar imagem

Quando usar

Use quando quiser respostas da Cognivo dentro de algo que você está construindo, em vez de dentro da Cognivo. Casos comuns:

• Um bot de comunidade em que alguém cola um endereço de contrato e recebe de volta sinais de risco, contexto de liquidez e de trava, e uma leitura de por que um token está em queda.
• Um painel de monitoramento para uma tesouraria, um time ou uma carteira baleia: exposição por aprovações, movimentações recentes, lucro e prejuízo realizado por token.
• Um notebook de pesquisa que puxa dados de tokens e carteiras para Python ou JavaScript, para um estudo ou uma análise pós-incidente.

Não é acesso bruto a node nem a RPC. Você sempre chama endpoints curados da Cognivo. Não há trading, execução de ordens nem ferramentas de MEV. Os resultados são sinais de inteligência, não aconselhamento financeiro, e um resultado limpo nunca significa que um token é seguro.

Onde encontrar

No dApp, abra a barra lateral, depois Account e então Developers. O link direto é dapp.cognivolabs.io/en/developers. Você precisa estar logado com sua conta Cognivo normal. Sem login, a página mostra apenas uma tela de orientação, sem projetos nem chaves.

O topo da página Desenvolvedores no dApp, onde você encontra a URL base e como enviar sua chave de API.Ampliar imagem

O cartão no topo da página traz as três coisas de que você precisa para fazer a primeira chamada:

• URL base: https://api.cognivolabs.io. Acrescente o caminho de um endpoint para fazer uma requisição.
• Autenticação: envie sua chave de API no cabeçalho X-API-Key em toda requisição. Mantenha a chave no seu servidor, nunca em código do navegador.
• Redes: a página mostra Ethereum, Base, and BSC live e More chains coming soon. Alguns endpoints suportam menos redes do que outros, e a Referência de endpoints diz quais.

O mesmo cartão traz links para esta documentação e para a especificação OpenAPI legível por máquina, que você pode importar no Postman, no Insomnia ou em um gerador de SDK.

A própria página tem quatro abas: Quickstart, Keys, Endpoints e Usage. Endpoints é uma referência com exemplos copiáveis e o preço de cada chamada. Não há executor ao vivo na página, então nada do que você lê ali gasta qualquer coisa.

Acesso, chaves e custo

As chaves live são self-service. Crie uma e ela funciona na hora, sem formulário de inscrição e sem fila de aprovação. O portal declara o modelo com clareza: alguns endpoints são gratuitos com qualquer chave ativa, e outros exigem acesso pago ou Enterprise e são cobrados por chamada bem-sucedida do seu saldo de créditos Cognivo.

• Chaves live (cogv_live_) fazem chamadas reais. Cada chamada bem-sucedida é cobrada em créditos Cognivo, no preço publicado para aquele endpoint. Chamadas que falham nunca são cobradas. A cobrança das chamadas da Developer API está desligada hoje, então uma chamada bem-sucedida não desconta nada e seu saldo não muda.
• Chaves de teste (cogv_test_) são rotuladas como Test no portal. Elas têm limites apertados e servem para experimentar a API, não para tráfego real.
• Toda chave mostra seu modo de acesso na aba Keys, como Paid, Trial, Partner, Sandbox, Enterprise ou Request access. Uma chave em Request access precisa ser aprovada antes de conseguir executar os endpoints pagos, e uma chave Suspended não consegue chamar nada. O portal mostra o motivo.
• Enterprise é o único caminho em que você solicita acesso, para preços e limites personalizados. O botão de acesso Enterprise abre o fluxo de suporte.

Os créditos vêm do mesmo saldo que você usa em todo o resto da Cognivo, e toda conta recebe 5 créditos gratuitos por dia, renovados à meia-noite UTC. Se o seu saldo não cobrir uma chamada, você recebe um erro 402 com o código payment_required, e nada é cobrado. Recarregue e tente de novo. Veja Cobrança e créditos para entender como o saldo funciona.

GET /v1/api/health é gratuito e não precisa de chave. GET /v1/api/me é gratuito com qualquer chave válida. GET /v1/api/discover é gratuito com um teto diário apertado. Os preços por endpoint estão na Referência de endpoints e em Limites de taxa, erros e cobrança.

O que volta e o que significa uma resposta em branco

As respostas trazem apenas inteligência on-chain pública. Elas nunca incluem identificadores de conta Cognivo, e-mails, saldos ou outros dados privados de conta, seus ou de qualquer pessoa. A única exceção é GET /v1/api/me, que informa o saldo de créditos da própria chave que fez a chamada, para você acompanhar seu gasto.

Um campo vazio ou um valor desconhecido significa que a Cognivo não conseguiu verificar aquele item para este token ou carteira nesta rede. Não significa que o item está ausente, e não significa que o alvo está limpo. Trate um resultado ausente como não verificado e use o ID da requisição na resposta se precisar dar seguimento.

Próximos passos

1. Faça login e crie um projeto, depois crie uma chave live. A chave completa é exibida uma única vez, então copie-a imediatamente.
2. Faça sua primeira chamada com o Início rápido.
3. Leia Autenticação e chaves de API para entender permissões, rotação e segurança das chaves.