AudioAlpha

Documentação de API e MCP

Acesse os dados do AudioAlpha programaticamente via nossa API REST ou conecte-se diretamente ao Claude ou Grok usando MCP (Model Context Protocol).

Gere sua Chave de API

As chaves de API fornecem acesso tanto à API REST quanto à integração MCP. Cada nível de assinatura inclui diferentes limites de taxa e acesso a endpoints.

1. 1
2. 2 Encontre a Seção de Acesso à API Role para baixo até o cartão "API Access"
3. 3 Gere a Chave Clique em "Generate API Key" para criar uma nova chave
4. 4 Armazene com Segurança Copie e armazene sua chave com segurança — ela será exibida apenas uma vez

Mantenha sua chave de API em segredo. Nunca a exponha em código do lado do cliente ou em repositórios públicos.

Conecte o MCP ao Claude Desktop

O MCP (Model Context Protocol) permite que o Claude acesse diretamente os dados do AudioAlpha durante as conversas. Pergunte ao Claude sobre sentimento de mercado, tendências e dados de ativos — ele buscará automaticamente no AudioAlpha.

Instruções de Configuração

1. 1 Abra as Configurações do Claude Desktop Vá em Configurações → Desenvolvedor → Editar Config
2. Adicione o Servidor MCP do AudioAlpha Adicione o seguinte ao seu claude_desktop_config.json:

   "mcpServers": {
     "audioalpha": {
       "command": "npx",
       "args": [
         "mcp-remote",
         "https://www.audioalpha.io/api/mcp?apiKey=sk_live_your_key"
       ]
     }
   }
   

3. 3 Substitua a Chave de API Substitua sk_live_your_key pela sua chave de API real de /account
4. 4 Reinicie o Claude Desktop Salve o arquivo de configuração e reinicie o Claude Desktop para aplicar as alterações

Exemplos de Prompts

"Qual é o sentimento atual para o Bitcoin?"

"Mostre-me os ativos em alta de ontem nos podcasts"

"Quais são os principais temas discutidos nos podcasts de mercado esta semana?"

Dica: Você também pode simplesmente pedir ao Claude para conectar e fornecer sua chave de API — ele o guiará pelas instruções de configuração mais recentes.

Conecte o MCP ao Grok

O MCP (Model Context Protocol) permite que o Grok acesse diretamente os dados do AudioAlpha durante as conversas. Pergunte ao Grok sobre sentimento de mercado, tendências e dados de ativos — ele buscará automaticamente no AudioAlpha.

Conectores personalizados em grok.com podem exigir o Grok Premium.

Instruções de Configuração

1. 1 Abra os Conectores do Grok Vá para grok.com/connectors e clique em Novo conector → Personalizado
2. 2 Nomeie o Conector Use qualquer nome que desejar — por exemplo, AudioAlpha
3. Defina a URL do Servidor Cole isto no campo URL do Servidor, substituindo o espaço reservado pela sua chave de API de /account:

   https://www.audioalpha.io/api/mcp?apiKey=sk_live_your_key
   

4. 4 Adicione o Conector Clique em Adicionar Conector. O AudioAlpha estará disponível em suas conversas com o Grok.

Exemplos de Prompts

"Qual é o sentimento atual para o Bitcoin?"

"Mostre-me os ativos em alta de ontem nos podcasts"

"Quais são os principais temas discutidos nos podcasts de mercado esta semana?"

Dica: Você também pode simplesmente pedir ao Grok para usar o conector do AudioAlpha — ele buscará inteligência ao vivo dos podcasts sob demanda.

API REST

Acesse os dados do AudioAlpha diretamente via nossa API REST. Todos os endpoints exigem autenticação via token Bearer.

Autenticação

curl -X GET "https://www.audioalpha.io/api/audioalpha-api/market/snapshot" \
  -H "Authorization: Bearer YOUR_API_KEY"

Formato do ticker: todos os tickers de criptomoedas DEVEM ter o sufixo -USD — ex.: BTC-USD, ETH-USD, SOL-USD. Símbolos simples como BTC não serão correspondidos.

Endpoints Principais

/market/snapshot

Insights diários de sentimento e narrativa do mercado

/ticker/snapshot?ticker=BTC-USD

Sentimento e sinais específicos de ativos (observe o sufixo -USD)

/market/history?days=30

Série temporal de snapshots diários do mercado (limitado por nível: free=7d, alpha=365d, pro=730d, enterprise=1000d)

/ticker/history?ticker=BTC-USD&days=30

Série temporal de snapshots diários por ativo (limitado por nível: free=7d, alpha=365d, pro=730d, enterprise=1000d)

/tickers/leaderboard

Ativos com melhor desempenho por várias métricas

Acesso a Dados Históricos

O endpoint /ticker/history retorna uma série temporal de snapshots diários. Para evitar back-testing em períodos históricos arbitrários, o acesso é limitado por nível:

• Free: até 7 dias, ancorado no snapshot mais recente
• Alpha: até 365 dias, ancorado no snapshot mais recente
• Pro: até 730 dias, ancorado no snapshot mais recente
• Enterprise: até 1000 dias, pode passar date para retroceder a janela

Para os níveis free / alpha / pro, o parâmetro de consulta date é silenciosamente ignorado — a janela sempre termina no snapshot disponível mais recente. Se hoje ainda não tiver snapshot, o snapshot existente mais recente é usado como âncora. Solicitações que excedem o limite de days por nível são silenciosamente limitadas. A resposta inclui tier_cap, effective_days, start_date, end_date e date_param_honored para que os clientes possam ver exatamente qual janela foi retornada.

Agendamento e Versionamento de Snapshots

O snapshot diário é gravado todos os dias e normalmente está disponível até 00:02 UTC no máximo. Como os podcasts não são publicados em um cronograma fixo, um episódio relevante é ocasionalmente indexado depois que o snapshot do dia já foi gravado — quando isso acontece, o snapshot é regenerado. A compilação inicial do fim do dia carrega o rótulo eod_utc; uma regeneração incrementa version_num e altera o rótulo para revised. Tanto a versão mais recente quanto a versão original eod_utc permanecem disponíveis.

Toda resposta derivada de snapshot sempre inclui um campo status: completed assim que o snapshot terminar de ser gerado (o caso normal), ou writing enquanto está sendo (re)gerado — normalmente durante a breve janela de compilação das 00:00–00:01 UTC. Este campo é retornado independentemente de version_info.

Defina version_info=true para ver exatamente qual revisão você recebeu. Os seguintes parâmetros de consulta controlam a seleção de versão nos endpoints de snapshot (/market/* e /ticker/*):

• version_number — qual revisão retornar. O padrão é -1 (a versão autoritativa mais recente). Solicite uma revisão específica (1, 2, …); se ela não existir para aquela data, a versão mais recente é retornada.
• version_info — defina como true para incluir metadados de versão na resposta: tanto version_num (o número da revisão) quanto um version_label legível por humanos (ex.: eod_utc, backfill, revised). Quando omitido, nenhum dos campos é incluído.
• snapshot_type — universo de ativos a ser usado. O padrão é crypto (tradfi é reservado para uma versão futura).

Endpoints de intervalo, ranking e feed personalizado (/market/history, /ticker/history, /tickers/leaderboard, /me/feed, /me/favorites/assets) sempre retornam a versão autoritativa mais recente por data e aceitam apenas snapshot_type e version_info.

curl -X GET "https://www.audioalpha.io/api/audioalpha-api/market/snapshot?version_number=-1&version_info=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Limites de Taxa

Plano	Por Minuto	Por Dia	Por Mês
Free	5	50	500
Alpha	20	500	4.000
Pro	60	5.000	100.000
Enterprise	300	50.000	Ilimitado

Veja a comparação completa dos recursos da API por plano em nossa página de Preços.

Pronto para começar?

Gere sua chave de API e comece a acessar os dados do AudioAlpha programaticamente.

Gerar Chave de API