API & MCP Documentation
Access AudioAlpha data programmatically via our REST API or connect directly to Claude or Grok using MCP (Model Context Protocol).
Get API Key
Generate your key in account settings
API Reference
Full endpoint documentation
Rate Limits
View limits by subscription tier
Generate Your API Key
API keys provide access to both the REST API and MCP integration. Each subscription tier includes different rate limits and endpoint access.
- 1Go to Account Settings
Navigate to /account (requires login)
- 2Find API Access Section
Scroll down to the "API Access" card
- 3Generate Key
Click "Generate API Key" to create a new key
- 4Store Securely
Copy and store your key securely - it will only be shown once
Connect MCP to Claude Desktop
MCP (Model Context Protocol) allows Claude to directly access AudioAlpha data during conversations. Ask Claude about crypto sentiment, market trends, and asset data - it will automatically fetch from AudioAlpha.
Setup Instructions
- 1Open Claude Desktop Settings
Go to Settings → Developer → Edit Config
- 2Add AudioAlpha MCP Server
Add the following to your
claude_desktop_config.json:"mcpServers": { "audioalpha": { "command": "npx", "args": [ "mcp-remote", "https://www.audioalpha.io/api/mcp?apiKey=sk_live_your_key" ] } } - 3Replace API Key
Replace
sk_live_your_keywith your actual API key from /account - 4Restart Claude Desktop
Save the config file and restart Claude Desktop to apply changes
Example Prompts
Tip: You can also simply ask Claude to connect and provide your API key - it will guide you through the latest setup instructions.
Connect MCP to Grok
MCP (Model Context Protocol) allows Grok to directly access AudioAlpha data during conversations. Ask Grok about crypto sentiment, market trends, and asset data — it will automatically fetch from AudioAlpha.
Setup Instructions
- 1Open Grok Connectors
Go to grok.com/connectors and click New connector → Custom
- 2Name the Connector
Use any name you like — for example
AudioAlpha - 3Set the Server URL
Paste this into the Server URL field, replacing the placeholder with your API key from /account:
https://www.audioalpha.io/api/mcp?apiKey=sk_live_your_key
- 4Add Connector
Click Add Connector. AudioAlpha will now be available in your Grok conversations.
Example Prompts
Tip: You can also simply ask Grok to use the AudioAlpha connector — it will pull live podcast intelligence on demand.
REST API
Access AudioAlpha data directly via our REST API. All endpoints require authentication via Bearer token.
Authentication
curl -X GET "https://www.audioalpha.io/api/audioalpha-api/market/snapshot" \ -H "Authorization: Bearer YOUR_API_KEY"
-USD — e.g. BTC-USD, ETH-USD, SOL-USD. Bare symbols like BTC will not match.Key Endpoints
/market/snapshotDaily market-wide sentiment and narrative insights
/ticker/snapshot?ticker=BTC-USDAsset-specific sentiment and signals (note the -USD suffix)
/ticker/history?ticker=BTC-USD&days=30Historical daily snapshots time series (tier-capped: free=7d, alpha=365d, pro=730d, enterprise=1000d)
/tickers/leaderboardTop performing assets by various metrics
Historical Data Access
The /ticker/history endpoint returns a time series of daily snapshots. To prevent back-testing on arbitrary historical periods, access is gated by tier:
- Free: up to 7 days, anchored to latest snapshot
- Alpha: up to 365 days, anchored to latest snapshot
- Pro: up to 730 days, anchored to latest snapshot
- Enterprise: up to 1000 days, can pass
dateto back-date the window
For free / alpha / pro tiers, the date query parameter is silently ignored — the window always ends at the most recent available snapshot. If today has no snapshot yet, the most recent existing snapshot is used as the anchor. Requests exceeding the per-tier days cap are silently capped. The response includes tier_cap, effective_days, start_date, end_date and date_param_honored so clients can see exactly what window was returned.
Rate Limits
| Plan | Per Minute | Per Day | Per Month |
|---|---|---|---|
| Free | 5 | 50 | 500 |
| Alpha | 20 | 500 | 4,000 |
| Pro | 60 | 5,000 | 100,000 |
| Enterprise | 300 | 50,000 | Unlimited |
See the full comparison of API features by plan on our Pricing page.
Ready to get started?
Generate your API key and start accessing AudioAlpha data programmatically.
Generate API Key