Pular para o conteúdo principal

Início rápido

Do zero ao seu primeiro resultado real de inteligência em cerca de um minuto: crie uma chave, cole um comando, leia a resposta.

1. Crie uma chave de API​

  1. Abra o portal do desenvolvedor e faça login com a sua conta Cognivo.
  2. Crie um projeto (por exemplo "Meu bot de trading").
  3. Crie uma chave de API. Escolha as permissões (escopos) de que ela precisa - para este início rápido, conceda Inteligência de tokens e carteiras (intel:read) e Leituras de liquidez (liquidity:read).
  4. Copie a chave agora. Ela é exibida exatamente uma vez; depois disso, apenas uma versão mascarada (cogv_live_****abcd) fica visível. Se você perdê-la, rotacione a chave.

As chaves vêm em dois ambientes:

  • cogv_test_... - chaves sandbox para testes de integração contra dados de chain ao vivo. Com tetos rígidos (25 requisições/hora, 100/dia); só conseguem executar uma pequena cota de demo ao vivo quando um administrador a habilita.
  • cogv_live_... - chaves de produção. Os endpoints de inteligência ao vivo exigem acesso trial, partner, pago ou enterprise; veja os modos de acesso.

2. Verifique sua chave​

curl 'https://api.cognivolabs.io/v1/api/me' \
  -H 'X-API-Key: YOUR_API_KEY'

Você recebe de volta sua chave mascarada, projeto, ambiente, escopos e limite de taxa por hora.

3. Teste um endpoint ao vivo (curl)​

Os endpoints de inteligência usam POST com um corpo JSON. Este comando exato executa uma verificação real de liquidez em um token real da Base (RWA Inc, um contrato público que usamos em demos). Ele executa para chaves com acesso: uma chave sandbox cuja cota de demo ao vivo um administrador habilitou, ou uma chave com acesso trial, partner, pago ou enterprise:

curl -X POST 'https://api.cognivolabs.io/v1/api/intel/liquidity' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chain":"base","address":"0xe2b1dc2d4a3b4e59fdf0c47b71a7a86391a8b35a"}'

Com acesso, você deve ver "ok": true com a identidade do token (nome/símbolo), um snapshot de mercado e o contexto de LP/lock em data. meta.credits_charged mostra quanto a chamada custou: 0 em cotas de demo sandbox ou de trial, ou o preço em créditos do endpoint (2 créditos para liquidez) no uso pago - chamadas com falha nunca são cobradas. Sem acesso a chamada não executa de graça: ela retorna um erro 403 claro como access_required, e você pode solicitar acesso trial ou enterprise pelo portal. Troque o address por qualquer contrato de token em eth, base ou bsc quando estiver pronto.

Mantenha sua chave em segredo

Nunca cole uma chave de API real em um repositório público, chat ou código do lado do cliente. A chave é exibida apenas uma vez na criação; se vazar, rotacione-a no portal.

4. A mesma chamada em JavaScript / TypeScript​

const res = await fetch("https://api.cognivolabs.io/v1/api/intel/liquidity", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.COGNIVO_API_KEY, // never hardcode keys
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();
if (json.ok) {
  console.log(json.data);        // the intelligence result
  console.log(json.meta.request_id); // keep for support/debugging
} else {
  console.error(json.error);
}

5. Formato da resposta​

Todos os endpoints respondem com o mesmo envelope:

{
  "ok": true,
  "data": { "...": "the result" },
  "meta": {
    "chain": "base",
    "request_id": "capi_...",
    "credits_charged": 0,
    "generated_at": "2026-07-08T00:00:00.000Z"
  }
}

Em caso de falha:

{ "ok": false, "error": "invalid_chain", "request_id": "capi_..." }

Mantenha sua chave segura​

  • Chame a API a partir de um servidor, nunca de código de navegador ou de cliente móvel.
  • Guarde a chave em uma variável de ambiente ou em um gerenciador de segredos.
  • Se uma chave pode ter vazado, revogue-a ou rotacione-a no portal - a chave antiga para de funcionar em menos de um minuto.