finXPNAPIBack to Platform
B2B API
Beta — free during beta

Integrate AI-Powered Stock Forecasts

Add 13 ensemble models, deep learning, and technical analysis to your platform with a single API call.

Starter

Free during beta
  • 500 requests/month
  • Stock quotes
  • Candlestick analysis
  • Live forecasts (3M horizon)
  • 30 req/min rate limit
  • Email support
POPULAR

Business

Free during beta
  • 5,000 requests/month
  • All forecast horizons (1-12M)
  • Technical indicators
  • Fundamental data
  • 60 req/min rate limit
  • Priority support

Enterprise

Free during beta
  • Unlimited requests
  • All features included
  • Highest rate limits
  • 120 req/min rate limit
  • Dedicated support
  • Custom integrations

Quick Start

# Get a stock quote
curl -H "X-API-Key: fxp_your_key_here" \
  "/api/v1/quote/AAPL"

# Run a 3-month forecast
curl -H "X-API-Key: fxp_your_key_here" \
  "/api/v1/forecast/AAPL?horizon=3"

# Get candlestick analysis
curl -H "X-API-Key: fxp_your_key_here" \
  "/api/v1/candlestick/AAPL"

# Check your API key status
curl -H "X-API-Key: fxp_your_key_here" \
  "/api/v1/status"

API Endpoints

GET/api/v1/quote/:symbolAUTH

Get real-time stock quote with price, exchange, and currency info.

GET/api/v1/forecast/:symbolAUTH

Run full ensemble forecast (13 R models + Chronos DL). Returns JSON with all model predictions, ensemble signal, and confidence. Query: ?horizon=3

GET/api/v1/candlestick/:symbolAUTH

Candlestick pattern detection with 25+ patterns, RSI, MACD, Bollinger Bands, and technical signal.

GET/api/v1/statusAUTH

Check API key status, usage counts, rate limits, and expiration.

GET/api/v1/plans

List available B2B plans with pricing and features.

POST/api/v1/subscribe

Create a new API key. Body: { email, plan }

Response Format

GET /api/v1/forecast/AAPL?horizon=3
{
  "success": true,
  "symbol": "AAPL",
  "horizon": 3,
  "forecast": {
    "ticker": "AAPL",
    "signal": "BULLISH",
    "models": {
      "bsts": { "forecast": [...], "signal": "BULLISH" },
      "adam": { "forecast": [...], "signal": "NEUTRAL" },
      "sma": { "forecast": [...], "signal": "BULLISH" },
      // ... 13 models total
    },
    "ensemble": {
      "forecast": [195.2, 198.7, 201.3],
      "direction": "UP",
      "confidence": 0.78
    },
    "chronos": {
      "available": true,
      "model": "Chronos-tiny",
      "target_price": 203.5,
      "signal": "BULLISH",
      "confidence": 0.72
    }
  },
  "disclaimer": "This data is provided for informational purposes only...",
  "dataAttribution": "Market data provided by Yahoo Finance.",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

Authentication

All authenticated endpoints require an X-API-Key header with your API key.

X-API-Key: fxp_a1b2c3d4e5f6...

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) are included in every response.

When rate limited, a 429 response includes Retry-After header with seconds to wait.

Forecast endpoints may take 30-90 seconds. Use appropriate timeouts in your HTTP client.

Get Your API Key

Payment integration coming soon. Keys created now are for testing.

By creating an API key, you agree to our Terms of Service. All data is for informational purposes only and does not constitute financial advice.