Cognivo Developer API
A Cognivo Developer API permite que você chame a mesma inteligência on-chain que alimenta o Cognivo Chat, o dApp e o bot do Telegram a partir do seu próprio app, bot, painel ou backend.
- URL base:
https://api.cognivolabs.io - Autenticação: chaves de API com escopos que você mesmo cria no portal do desenvolvedor
- Chains ativas hoje: Ethereum (
eth), Base (base), BNB Smart Chain (bsc) - Solana: em breve (ainda não disponível)
- Webhooks: planejados (ainda não disponíveis)
- Especificação OpenAPI: cognivo-public-api.yaml - a especificação completa legível por máquina; importe no Postman, Insomnia ou em um gerador de SDK
O que posso construir?
Qualquer coisa que precise de uma leitura rápida e honesta de um token ou carteira. Algumas ideias concretas:
- Bots de verificação de segurança de tokens - um bot em que os usuários colam um endereço de contrato e recebem sinais de risco, contexto de liquidez e locks, e o "por que está caindo" em uma única mensagem
- Painéis de monitoramento de carteiras - acompanhe uma tesouraria, uma baleia ou uma carteira do time: exposição a aprovações, movimentos recentes exatos, PnL realizado por token
- Ferramentas comunitárias para Telegram ou Discord - dê à sua comunidade um comando
/check <token>apoiado na mesma inteligência que alimenta o Cognivo Chat - Visões de PnL de portfólio - mostre aos usuários o lucro e prejuízo realizado por token, calculado a partir de atividade on-chain verificada em vez de números autodeclarados
- Notebooks de pesquisa - traga dados de risco, liquidez, carteiras do time e movimentos para notebooks em Python ou JavaScript para estudos de tokens e post-mortems
- Feeds de descoberta - exiba no seu próprio app ou site os cards de inteligência pública recentes e de alta qualidade do feed Discover
O que esta API não é
- Não é acesso bruto a nós/RPC. Você sempre chama endpoints de inteligência curados da Cognivo; o RPC bruto da chain nunca é exposto nem revendido.
- Não inclui trading, execução de ordens nem ferramentas de MEV.
- Os resultados são sinais de inteligência, não aconselhamento financeiro nem uma garantia. Um resultado limpo nunca significa "seguro".
Modelo de acesso e preços
A Developer API é controlada por acesso durante o acesso antecipado. Toda chave pode explorar: ler a documentação, chamar GET /v1/api/health, inspecionar a si mesma com GET /v1/api/me e fazer chamadas limitadas de sandbox/demo. Os endpoints de inteligência ao vivo exigem acesso trial, partner, pago ou enterprise.
- O uso pago é cobrado em créditos Cognivo por chamada bem-sucedida; chamadas com falha não são cobradas.
- As chaves sandbox (
cogv_test_) são para testes de integração: com tetos rígidos (25 requisições/hora, 100/dia), e só conseguem executar uma pequena cota de demo ao vivo quando um administrador a habilita. - O acesso trial é concedido por um administrador, limitado e com prazo de expiração.
- Enterprise é sob medida: preços, limites maiores e acesso específico por endpoint. Solicite acesso pelo portal do desenvolvedor.
Chamar um endpoint executável sem acesso retorna um erro claro (por exemplo access_required, trial_expired ou payment_required) em vez de executar de graça. Os custos em créditos por endpoint estão publicados nas páginas de Referência de endpoints e Limites de taxa.
Privacidade e segurança dos dados
A API retorna apenas inteligência on-chain pública. As respostas nunca incluem identificadores de contas Cognivo, e-mails, saldos ou outros dados privados de conta - nem os seus nem os de mais ninguém.
Primeiros passos
- Faça login em dapp.cognivolabs.io/en/developers com a sua conta Cognivo normal.
- Crie um projeto e uma chave de API (a chave completa é exibida exatamente uma vez - copie imediatamente).
- Siga o Início rápido.