AlphaTerminal API
Power your trading apps with real-time AI signals, liquidation data, and market intelligence.
The AlphaTerminal API exposes the same engines that drive the trading terminal — AI analysis, scanner signals, liquidation maps, copy-trading signals — as a clean REST API. Get an API key, make a call, get data. No infrastructure required.
https://alphasterminal.com/api/v1
Quick Start
# AI analysis for Bitcoin curl -X POST https://alphasterminal.com/api/v1/analyze \ -H "X-Api-Key: at_your_key_here" \ -H "Content-Type: application/json" \ -d '{"ticker":"BTC"}'
import requests
resp = requests.post(
"https://alphasterminal.com/api/v1/analyze",
headers={"X-Api-Key": "at_your_key_here"},
json={"ticker": "BTC"}
)
print(resp.json())
const res = await fetch("https://alphasterminal.com/api/v1/analyze", { method: "POST", headers: { "X-Api-Key": "at_your_key_here", "Content-Type": "application/json" }, body: JSON.stringify({ ticker: "BTC" }) }); console.log(await res.json());
Authentication
All /api/v1/* requests require an API key in the X-Api-Key header:
X-Api-Key: at_your_key_here
Also accepted as a Bearer token:
Authorization: Bearer at_your_key_here
Get your key from the API tab in the AlphaTerminal terminal. All keys begin with at_.
Rate Limits
Limits reset daily at midnight UTC. Exceeding your limit returns 429 Too Many Requests. Every successful response includes remaining_today so you can track quota programmatically.
| Plan | Daily Limit | Data Freshness | Endpoints |
|---|---|---|---|
| Developer (Free) | 100 calls/day | 15-min delay | Basic |
| Startup ($99/mo) | 10,000 calls/day | Real-time | All |
| Business ($499/mo) | 100,000 calls/day | Real-time | All + mispricings |
| Enterprise ($2,499/mo) | Unlimited | Real-time | All + dedicated |
Errors
| Code | Error Key | Meaning |
|---|---|---|
| 200 | — | Success |
| 400 | missing_ticker | Required parameter missing |
| 401 | missing_api_key / invalid_key | No key provided or key not found |
| 402 | tier_required | Endpoint requires a higher plan |
| 403 | key_revoked | API key has been disabled |
| 429 | rate_limit_exceeded | Daily call limit reached |
| 500 | *_unavailable | Upstream service error |
Error Shape
{ "error": "rate_limit_exceeded", "message": "Daily limit reached. Upgrade..." }
GET /v1/status
Health check and auth verification. Does not consume a rate-limit call.
Response
{ "status": "ok", "version": "v1", "authenticated": true, "timestamp": "2026-04-30T23:00:00Z" }
POST /v1/analyze
AI-powered analysis for a ticker. Developer tier includes a 15-min delay notice.
Request Body
| Param | Type | Description |
|---|---|---|
| ticker required | string | Symbol: "BTC", "ETH", "SOL", etc. |
| context | string | Optional additional context |
Response
{
"success": true, "ticker": "BTC",
"analysis": {
"price_usd": 67420.50, "change_24h_pct": 3.14,
"sentiment": "bullish", "data_freshness": "realtime"
},
"tier": "startup", "remaining_today": 9987
}
GET /v1/signals
Real-time scanner signals — momentum, analyst upgrades, and unusual options flow.
Query Params
| Param | Type | Default | Description |
|---|---|---|---|
| type | string | all | all, momentum, analyst, options_flow |
| limit | integer | 20 | Max 100 per signal type |
GET /v1/liquidations/:symbol
Open interest history + estimated liquidation zones for a perpetual futures symbol.
Path Params
| Param | Description |
|---|---|
| symbol required | Ticker (BTC, ETH, SOL). Appended with USDT for perps. |
Response
{
"symbol": "BTC",
"liquidations": {
"open_interest_history": [...],
"estimated_liquidation_zones": [
{ "price_offset_pct": -5, "strength": "high", "side": "long" }
]
}
}
GET /v1/copy-signals
Recent copy-trading executions from tracked whale wallets. Useful for building signal bots.
Query Params
| Param | Type | Default | Description |
|---|---|---|---|
| limit | integer | 10 | Max 50 |
GET /v1/prices
Aggregated price feed across exchanges. Up to 20 symbols per call.
Query Params
| Param | Type | Default | Description |
|---|---|---|---|
| symbols | string | BTC,ETH,SOL | Comma-separated tickers. Max 20. |
GET /v1/mispricings
Polymarket prediction market mispricings from AlphaTerminal's scanner. Exclusive to Business and Enterprise plans.
Response
{
"mispricings": [
{
"market_question": "Will BTC close above $70K by May 31?",
"yes_price": 0.62, "fair_value": 0.71, "edge_pct": 14.5
}
],
"tier": "business", "remaining_today": 98201
}
Pricing & Tiers
Tiers are managed through your AlphaTerminal account. Upgrade anytime — changes take effect immediately.
Ready to integrate?
Free developer key in under 60 seconds. No credit card required.
Get Started Free →