AudioAlpha

Documentación de API y MCP

Accede a los datos de AudioAlpha programáticamente a través de nuestra API REST o conéctate directamente a Claude o Grok usando MCP (Model Context Protocol).

Genera tu clave de API

Las claves de API proporcionan acceso tanto a la API REST como a la integración MCP. Cada nivel de suscripción incluye diferentes límites de velocidad y acceso a endpoints.

1. 1
2. 2 Encuentra la sección de Acceso a la API Desplázate hacia abajo hasta la tarjeta "Acceso a la API"
3. 3 Genera la clave Haz clic en "Generar clave de API" para crear una nueva clave
4. 4 Almacena de forma segura Copia y guarda tu clave de forma segura: solo se mostrará una vez

Mantén tu clave de API en secreto. Nunca la expongas en código del lado del cliente o en repositorios públicos.

Conecta MCP a Claude Desktop

MCP (Model Context Protocol) permite a Claude acceder directamente a los datos de AudioAlpha durante las conversaciones. Pregunta a Claude sobre el sentimiento del mercado, tendencias y datos de activos: obtendrá automáticamente la información de AudioAlpha.

Instrucciones de configuración

1. 1 Abre la configuración de Claude Desktop Ve a Configuración → Desarrollador → Editar configuración
2. Añade el servidor MCP de AudioAlpha Añade lo siguiente a tu claude_desktop_config.json:

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

3. 3 Reemplaza la clave de API Reemplaza sk_live_your_key con tu clave de API real de /account
4. 4 Reinicia Claude Desktop Guarda el archivo de configuración y reinicia Claude Desktop para aplicar los cambios

Ejemplos de prompts

"¿Cuál es el sentimiento actual de Bitcoin?"

"Muéstrame los activos con mayor crecimiento de los podcasts de ayer"

"¿Cuáles son los temas principales que se discuten en los podcasts de mercado esta semana?"

Consejo: También puedes simplemente pedirle a Claude que se conecte y proporcionar tu clave de API: te guiará a través de las últimas instrucciones de configuración.

Conecta MCP a Grok

MCP (Model Context Protocol) permite a Grok acceder directamente a los datos de AudioAlpha durante las conversaciones. Pregunta a Grok sobre el sentimiento del mercado, tendencias y datos de activos: obtendrá automáticamente la información de AudioAlpha.

Los conectores personalizados en grok.com pueden requerir Grok Premium.

Instrucciones de configuración

1. 1 Abre los conectores de Grok Ve a grok.com/connectors y haz clic en Nuevo conector → Personalizado
2. 2 Nombra el conector Usa cualquier nombre que quieras, por ejemplo AudioAlpha
3. Establece la URL del servidor Pega esto en el campo URL del servidor, reemplazando el marcador de posición con tu clave de API de /account:

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

4. 4 Añade el conector Haz clic en Añadir conector. AudioAlpha estará disponible en tus conversaciones de Grok.

Ejemplos de prompts

"¿Cuál es el sentimiento actual de Bitcoin?"

"Muéstrame los activos con mayor crecimiento de los podcasts de ayer"

"¿Cuáles son los temas principales que se discuten en los podcasts de mercado esta semana?"

Consejo: También puedes simplemente pedirle a Grok que use el conector de AudioAlpha: obtendrá inteligencia de podcasts en vivo bajo demanda.

API REST

Accede a los datos de AudioAlpha directamente a través de nuestra API REST. Todos los endpoints requieren autenticación mediante token Bearer.

Autenticación

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

Formato de ticker: todos los tickers de criptomonedas DEBEN tener el sufijo -USD — p. ej. BTC-USD, ETH-USD, SOL-USD. Los símbolos simples como BTC no coincidirán.

Endpoints clave

/market/snapshot

Información diaria sobre el sentimiento y las narrativas del mercado

/ticker/snapshot?ticker=BTC-USD

Sentimiento y señales específicos de activos (nota el sufijo -USD)

/market/history?days=30

Serie temporal de instantáneas diarias del mercado (limitada por nivel: free=7d, alpha=365d, pro=730d, enterprise=1000d)

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

Serie temporal de instantáneas diarias por activo (limitada por nivel: free=7d, alpha=365d, pro=730d, enterprise=1000d)

/tickers/leaderboard

Activos con mejor rendimiento según varias métricas

Acceso a datos históricos

El endpoint /ticker/history devuelve una serie temporal de instantáneas diarias. Para evitar pruebas retrospectivas en períodos históricos arbitrarios, el acceso está limitado por nivel:

• Free: hasta 7 días, anclado a la instantánea más reciente
• Alpha: hasta 365 días, anclado a la instantánea más reciente
• Pro: hasta 730 días, anclado a la instantánea más reciente
• Enterprise: hasta 1000 días, puede pasar date para retroceder la ventana

Para los niveles free / alpha / pro, el parámetro de consulta date se ignora silenciosamente: la ventana siempre termina en la instantánea más reciente disponible. Si hoy aún no hay instantánea, se usa la instantánea existente más reciente como ancla. Las solicitudes que exceden el límite days por nivel se limitan silenciosamente. La respuesta incluye tier_cap, effective_days, start_date, end_date y date_param_honored para que los clientes puedan ver exactamente qué ventana se devolvió.

Programación de instantáneas y versionado

La instantánea diaria se escribe todos los días y normalmente está disponible a más tardar a las 00:02 UTC. Debido a que los podcasts no se publican con un horario fijo, ocasionalmente un episodio relevante se indexa después de que ya se haya escrito la instantánea del día; cuando eso sucede, la instantánea se regenera. La compilación inicial de fin de día lleva la etiqueta eod_utc; una regeneración incrementa version_num y cambia la etiqueta a revised. Tanto la versión más reciente como la original eod_utc permanecen disponibles.

Toda respuesta derivada de una instantánea incluye siempre un campo status: completed una vez que la instantánea ha terminado de generarse (el caso normal), o writing mientras se está (re)generando, típicamente durante la breve ventana de compilación de 00:00–00:01 UTC. Este campo se devuelve independientemente de version_info.

Establece version_info=true para ver exactamente qué revisión recibiste. Los siguientes parámetros de consulta controlan la selección de versión en los endpoints de instantáneas (/market/* y /ticker/*):

• version_number — qué revisión devolver. Por defecto es -1 (la última versión autoritativa). Solicita una revisión específica (1, 2, …); si no existe para esa fecha, se devuelve la última versión en su lugar.

• version_info — establece true para incluir metadatos de versión en la respuesta: tanto version_num (el número de revisión) como un version_label legible por humanos (p. ej. eod_utc, backfill, revised). Cuando se omite, no se incluye ninguno de los campos.

• snapshot_type — universo de activos del que extraer. Por defecto es crypto (tradfi está reservado para una futura versión).

Los endpoints de rango, clasificación y feed personalizado (/market/history, /ticker/history, /tickers/leaderboard, /me/feed, /me/favorites/assets) siempre devuelven la última versión autoritativa por fecha y aceptan solo snapshot_type y 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"

Límites de velocidad

Plan	Por minuto	Por día	Por mes
Free	5	50	500
Alpha	20	500	4,000
Pro	60	5,000	100,000
Enterprise	300	50,000	Ilimitado

Consulta la comparación completa de las funciones de la API por plan en nuestra página de precios.

¿Listo para empezar?

Genera tu clave de API y comienza a acceder a los datos de AudioAlpha programáticamente.

Generar clave de API