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 /snapshot?ticker=AAPL&as_of=2022-03-01 AI-friendly Markdown historical snapshot
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 Point-in-Time Snapshot

Snapshot v0 returns an AI-friendly Markdown historical financial snapshot for a ticker as of a specific date. It costs 1 credit and requires API key authentication.

It includes:

  • Market context: recent price action, performance metrics, technical indicators, and market interpretation ending at as_of
  • Company filings and financials available before as_of
  • Parsed filing excerpts and key historical business context
  • Historical news and discussion context when available
  • Metadata with status, warnings, and cache information

Parameters:

Parameter Required Description
ticker Yes Stock ticker, for example AAPL
as_of Yes Historical date in YYYY-MM-DD format 
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://mcp.plusefin.com/api/snapshot?ticker=AAPL&as_of=2022-03-01"

Response schema:

{
  "ticker": "AAPL",
  "as_of": "2022-03-01",
  "format": "markdown",
  "data": "# AAPL Point-in-Time Financial Snapshot\n...",
  "metadata": {
    "warnings": [],
    "cache": {
      "status": "miss",
      "created_at": "...",
      "expires_at": null
    }
  }
}

Cache behavior:

  • Historical snapshots where as_of is before today do not expire.
  • Same-day snapshots expire after 1 hour.
  • See Snapshot Tools for the MCP tool parameters.

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.