Developer Documentation
Welcome to the MarketLens AI API. This documentation provides information on how to access our AI-driven market analysis, sentiment scoring, and price forecasting engines.
Authentication
MarketLens AI uses Bearer Token authentication. You must include your unique API Key in the header of every request.
Core Endpoint
Get Market Analysis
Retrieves the complete AI analysis, signals, forecast, and insider data for a specific asset.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Ticker symbol (e.g., NVDA, AAPL). |
| interval | string | No | Timeframe (e.g., 1d). Defaults to 1d. |
Response Fields Explained
- signal: The AI's verdict (STRONG_BUY, BUY, HOLD, SELL).
- ai_confidence: A score from 0.0 to 1.0 indicating algorithm certainty.
- insider_sells: Data regarding company executives selling their own shares.
- forecast: AI-generated price projection for the next period.
⚖️ Legal, Policy & Fraud Protection
By using the MarketLens AI API, you agree to be bound by the following strict terms.
1. Strict Commercial Use Policy
Standard API keys are strictly for PERSONAL, NON-COMMERCIAL use only.
You are expressly PROHIBITED from using the API data for: creating paid apps, reselling data, or managing third-party funds.
Commercial Exception: Commercial use is ONLY permitted if you have signed a separate Partnership Agreement. Contact us at [email protected].
2. Disclaimer of Liability
MarketLens AI provides data based on probabilistic AI models. This data is for informational purposes only and does NOT constitute financial advice. We are not responsible for any financial losses.