REST API
Direct HTTP API access to PlusE financial data endpoints.
REST API Reference
This page documents the REST API for direct HTTP access to PlusE financial data.
Using MCP for AI agents instead? See the MCP Tools Reference.
Base URL
https://mcp.plusefin.com/api
Authentication
Include your API key in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" "https://mcp.plusefin.com/api/tools/ticker/AAPL"
Get your API key at console.plusefin.com.
Endpoints
Stock Data
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/ticker/{symbol} |
Company overview and metrics |
| GET | /tools/price-history?ticker=AAPL&period=6mo |
Historical prices |
| GET | /tools/options/{symbol} |
Options chain data |
| GET | /tools/statements/{symbol} |
Financial statements |
| GET | /tools/holders/{symbol} |
Institutional holdings |
| GET | /tools/earnings/{symbol} |
Earnings history |
| GET | /tools/news/{symbol} |
Stock news |
| GET | /tools/top25/{symbol} |
Top 25 holdings |
| GET | /tools/insiders/{symbol} |
Insider trading |
Options
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/options/analyze/{symbol} |
Options analysis |
Predictions
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/prediction/{symbol} |
Price prediction |
Market Sentiment
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/sentiment |
Market sentiment index |
| GET | /tools/sentiment/history?days=10 |
Historical sentiment |
| GET | /tools/sentiment/trend?days=10 |
Sentiment trend |
Macro Data
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/fred/{series_id} |
FRED economic data |
| GET | /tools/fred/search?q=gdp |
Search FRED series |
News
| Method | Endpoint | Description |
|---|---|---|
| GET | /tools/news/market |
CNBC market news |
| GET | /tools/news/social?keywords=tsla,nvda |
Social media discussions |
Examples
Get Stock Data
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mcp.plusefin.com/api/tools/ticker/AAPL"
Get Price History
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mcp.plusefin.com/api/tools/price-history?ticker=NVDA&period=1y"
Get Options Data
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mcp.plusefin.com/api/tools/options/TSLA?num_options=20"
Get Market Sentiment
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mcp.plusefin.com/api/tools/sentiment"
Get Price Prediction
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://mcp.plusefin.com/api/tools/prediction/AAPL"
Swagger Documentation
Visit https://mcp.plusefin.com/api/docs for interactive API documentation.