quick-btc-check — a primeira habilidade do Algovault e sua importância

Introdução

A maioria dos construtores de agentes não quer se tornar quants. Eles querem uma resposta em uma linha para "o que o BTC está fazendo agora, e meu bot deve se importar?" Essa é a razão pela qual lançamos quick-btc-check como a primeira Habilidade do AlgoVault: um único verbo, uma única resposta, zero código de cola. Por trás das câmeras, ele utiliza o mesmo motor de veredicto composto que alimenta nossa API completa — aquele com um histórico de 91,7% de taxa de vitória PFE · 472.890+ chamadas verificadas · ancorado em Merkle na Base L2 — mas a superfície é deliberadamente estreita. Uma chamada. Um veredicto. Uma razão. Essa é a promessa do M5: remover a fricção que impede construtores curiosos de fazer a primeira solicitação.

Este post é o destaque dessa habilidade: por que ela existe, o que ela retorna, como integrá-la e onde ela deliberadamente para.

O problema: a primeira chamada é onde os construtores desistem

Observe um novo desenvolvedor de agentes tentando adicionar "consciência de mercado" ao seu bot. Eles escolhem um SDK de exchange. Eles leem sobre REST vs WebSocket. Eles conectam as taxas de financiamento. Eles descobrem que o interesse aberto está em um endpoint diferente. Eles tentam construir uma heurística "o BTC está em alta?" a partir de três indicadores brutos e imediatamente enfrentam a pergunta que todo quant já enfrentou: como eu peso isso? Quando eles têm um protótipo funcional, escreveram 400 linhas de código de cola e ainda não confiam na resposta.

A razão estrutural pela qual isso acontece: APIs de indicadores brutos vendem os ingredientes, não a refeição. A taxa de financiamento por si só é ruído. A mudança no interesse aberto por si só é ruído. A classificação de regime é um problema de pesquisa, não uma chamada REST. Todo construtor que quer "um veredicto" acaba escrevendo sua própria camada de pontuação composta — mal, sem um histórico, e sem cobertura entre venues. Esse é o imposto que estamos removendo. quick-btc-check é o que acontece quando você se recusa a fazer da primeira chamada um projeto de pesquisa.

A resposta do AlgoVault: uma habilidade, um veredicto, uma razão

Uma Habilidade no sentido do AlgoVault é uma chamada de ferramenta MCP escopo com uma superfície padrão opinativa. quick-btc-check é um wrapper em torno de get_trade_signal com BTC fixo, intervalo de tempo padrão definido para o padrão intradiário curto, e a forma da resposta achatada para que um modelo de linguagem possa lê-la em um único olhar. Ele retorna o mesmo veredicto composto que a API completa — mesmo classificador de regime, mesmo livro de fatores, mesmos resultados rastreados por PFE — mas podado para os campos que um agente realmente precisa para tomar uma decisão no próximo tick.

A camada de proteção que isso atinge é a Proteção #1 (veredicto composto). Cada campo na resposta vem do mesmo modelo de ponderação contra o qual temos publicado resultados por meses. A conexão com o M5 é que a habilidade remove a barreira "eu preciso aprender o esquema primeiro": seu agente pode chamá-la antes de entender o que qualquer um dos indicadores subjacentes significa, e a string de raciocínio explicará o veredicto em inglês simples. Essa é a remoção da fricção que estamos otimizando — não menos bytes pela rede, mas menos decisões que o construtor precisa tomar antes de obter uma saída útil.

Passo a passo da implementação

Três blocos: instalação, resposta ao vivo, loop do agente. Tudo isso roda contra api.algovault.com, sem simulações.

Bloco 1: instalação e primeira chamada

A habilidade é enviada como parte do servidor MCP do AlgoVault. Instale via npx; sem etapa de construção, sem arquivo de configuração para o caminho feliz.

# Adicione o servidor MCP do AlgoVault à sua configuração do Claude Desktop / Code / Cursor
npx -y @algovaultlabs/crypto-quant-signal-mcp@^1.27 --install claude-code

# Ou invoque a habilidade diretamente para um teste rápido
export ALGOVAULT_API_KEY="av_live_..."
npx -y @algovaultlabs/crypto-quant-signal-mcp@^1.27 \
  --skill quick-btc-check

Essa é toda a superfície de configuração. Sem chaves de exchange para provisionar, sem dança de limite de taxa para configurar, sem seleção de indicadores. O nível gratuito oferece 200 chamadas/mês (também expressável como 100 chamadas/dia), o que é suficiente para rodar um agente de hobby em uma cadência de vários minutos e nunca tocar em um paywall.

Bloco 2: como a resposta realmente se parece

Aqui está uma resposta literal de uma chamada ao vivo — sem campos sintéticos, sem seções omitidas. Note o bloco de metadados _algovault (versão, sessão, cota) e o bloco _receipts (livro de fatores, instantâneo de histórico, URI de verificação). Essas são as duas peças que tornam isso composável em um loop de agente: os metadados permitem que você faça cache e limite de taxa, e os recibos permitem que você mostre seu raciocínio.

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"call\": \"HOLD\",\n  \"confidence\": 1,\n  \"price\": 63554.2,\n  \"regime\": \"TRENDING_UP\",\n  \"reasoning\": \"2 fatores internos não mostrados aqui são bearish, e eles carregam essa leitura. Contra: o regime está em alta na cruz de média móvel → bullish. Torna-se acionável se a quebra se resolver.\",\n  \"internal_factors\": [\n    \"bearish\"\n  ]\n}
  }