AlphaBee API
Access real-time trade intelligence from 100+ elite traders on X. Get AI-extracted trade ideas, market insights, technical indicators, and deep analysis — all through a simple REST API.
Quick Start
curl -X GET "https://api.alphabee.app/api/latest-ideas"No API key required during our open beta — just make the request and go. Sign up for a full AlphaBee account.
Authentication
Open Access — No API Key Required
During our open beta, all endpoints are publicly accessible with no authentication needed. Just make your request and go.
Start Immediately
No sign-up or API key needed to start integrating. Copy any example below and run it — it works right away.
Future Plans
API keys and rate-limited tiers are coming post-beta. Sign up now to lock in early access.
Rate Limits
During the free beta, generous rate limits ensure fair usage for all developers. Rate limit headers are included in every response.
| Plan | Requests / min | Requests / day | Price |
|---|---|---|---|
BetaCURRENT | 60 | 1,000 | Free |
| Pro (Coming Soon) | 120 | 10,000 | TBD |
| Enterprise (Coming Soon) | Unlimited | Unlimited | Contact Us |
Response Headers
X-RateLimit-Limit—Maximum requests per windowX-RateLimit-Remaining—Remaining requests in current windowX-RateLimit-Reset—Unix timestamp when the window resetsEndpoints
Base URL: https://api.alphabee.app
/api/latest-ideasGet Latest Trade Ideas
Fetch the most recent batch of AI-extracted trade ideas and market insights. Updated daily at 12:00 AM UTC from 100+ curated elite traders on X.
Code Examples
curl -X GET "https://api.alphabee.app/api/latest-ideas"/api/searchSearch Trade Ideas & Insights
Search across all stored trade ideas, market insights, and live tweets. Supports real-time AI-powered summaries via Server-Sent Events.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Required | Search query (minimum 2 characters). Searches across tickers, trader names, rationale, categories, and summaries. |
| stream | boolean | Optional | Set to "true" to receive an AI-generated summary as a Server-Sent Events stream. Default: false. |
Code Examples
curl -X GET "https://api.alphabee.app/api/search?q=AAPL"/api/technicalsGet Technical Indicators
Fetch real-time technical analysis indicators for any ticker — RSI, MACD, and Bollinger Bands powered by Alpha Vantage.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | Required | The stock or ETF ticker symbol (e.g., "AAPL", "SPY"). |
| interval | string | Optional | Time interval for indicators. Default: "daily". |
Code Examples
curl -X POST "https://api.alphabee.app/api/technicals" \
-H "Content-Type: application/json" \
-d '{"ticker": "AAPL"}'/api/insight-detailsDeep Insight Analysis
Get AI-powered deep-dive analysis on any market insight with fact-checking, risk assessment, and related context. Powered by GPT-4o.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| insight | MarketInsight | Required | The full insight object to analyze (must include category, summary, description, relevantTickers, and trader info). |
Code Examples
curl -X POST "https://api.alphabee.app/api/insight-details" \
-H "Content-Type: application/json" \
-d '{
"insight": {
"category": "sector-rotation",
"summary": "Flow rotating into defensives",
"description": "Multiple traders noting...",
"relevantTickers": ["XLU", "XLP"],
"trader": { "username": "macrotrader" }
}
}'Error Handling
The API uses standard HTTP status codes. All error responses include a JSON body with an error field describing the issue.
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid or missing parameters. |
| 404 | Not Found | Endpoint or resource not found. |
| 429 | Too Many Requests | Rate limit exceeded. Retry after the reset window. |
| 500 | Internal Server Error | An unexpected error occurred. Please retry. |
| 503 | Service Unavailable | Upstream data source temporarily unavailable. |
Example Error Response
{
"error": "Missing required parameter: ticker",
"status": 400
}Type Reference
Core TypeScript types returned by the API. Use these as a reference for building type-safe integrations.
interface TradeIdea {
id: string;
ticker: string;
direction: 'bullish' | 'bearish';
assetClass: 'equity' | 'crypto' | 'future' | 'forex';
securityType: 'stock' | 'etf' | 'index-fund' | 'option' | 'crypto' | 'future' | 'forex';
timeframe: 'intraday' | 'swing' | 'position' | 'long-term';
rationale: string;
confidence: number; // 0.0 – 1.0
trader: Trader;
createdAt: string; // ISO 8601 timestamp
sourceUrl: string;
tweetText?: string;
fundamentalAnalysis?: FundamentalAnalysis;
}interface MarketInsight {
id: string;
category: 'market-sentiment' | 'volatility' | 'event'
| 'sector-rotation' | 'technical' | 'macro';
summary: string;
description: string;
relevantTickers?: string[];
trader: Trader;
confidence: number; // 0.0 – 1.0
createdAt: string; // ISO 8601 timestamp
sourceUrl: string;
}interface Trader {
id: string;
username: string;
displayName: string;
profileImageUrl?: string;
bio?: string;
followersCount: number;
verified: boolean;
}interface FundamentalAnalysis {
signal: 'supported' | 'neutral' | 'contradicted';
analysis: string;
initialConfidence: number;
finalizedConfidence: number;
metrics: {
marketCap?: string;
peRatio?: string;
eps?: string;
profitMargin?: string;
beta?: string;
week52High?: string;
week52Low?: string;
};
}Ready to Build?
No API key needed — start integrating AlphaBee's trade intelligence into your applications right now, for free.