curl https://www.oxfordledge.com/api/data?ticker=AAPL \
  -H "X-API-Key: ol_your_api_key_here"

{
  "ticker": "AAPL",
  "price": { "current": 187.44, "changePct": 1.23 },
  "metrics": { "pe": 28.5, "marketCap": "2.89T" }
}

API Documentation

Access Oxford Ledge's financial data programmatically. Stock quotes, fundamentals, SEC filings, screener, portfolio management, and more — all via a simple REST API.

Authentication

All API requests require authentication via an API key. Generate your key from Settings → API Keys in the platform.

Send your key as a Bearer token with every request (canonical; the X-API-Key header is also accepted — both work, use one):

# Using curl
curl -H "Authorization: Bearer ol_your_api_key_here" \
  https://www.oxfordledge.com/api/data?ticker=AAPL

# Using Python requests
import requests

headers = {"Authorization": "Bearer ol_your_api_key_here"}
r = requests.get("https://www.oxfordledge.com/api/data",
               params={"ticker": "AAPL"},
               headers=headers)
data = r.json()

Base URL

API versioning is supported: /api/v1/* routes to the same handlers as /api/*. Both are interchangeable.

Rate Limits

Rate limits are applied per IP address. When exceeded, the API returns 429 Too Many Requests with a Retry-After header.

Response Format

All responses are JSON. Successful responses return the data directly:

{
  "ticker": "AAPL",
  "price": {
    "current": 189.84,
    "change": 2.15,
    "changePercent": 1.14
  },
  "fundamentals": { ... },
  "fetchedAt": "2026-04-03T10:30:00"
}

Errors

Error responses include an error field with a human-readable message:

{
  "error": "No ticker provided"
}
// HTTP 400, 401, 403, 404, or 429

Common error codes:

• 400 — Missing or invalid parameter
• 401 — Authentication required (missing or invalid API key)
• 403 — Feature requires a higher subscription tier
• 429 — Rate limit exceeded or monthly budget reached
• 500 — Server error

Endpoints

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/data?ticker=AAPL"

{
  "ticker": "AAPL",
  "price": {"current": 189.84, "change": 2.15, "changePercent": 1.14},
  "fundamentals": {"marketCap": 2950000000000, "pe": 31.2, "eps": 6.08, ...},
  "profile": {"name": "Apple Inc", "sector": "Technology", ...},
  "filings": [{"form": "10-K", "filed": "2025-11-01", ...}],
  "fetchedAt": "2026-04-03T10:30:00"
}

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/ticker-search?q=apple"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/random-ticker"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/fundamentals-pit?ticker=AAPL&date=2025-06-30"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/screener?min_mcap=10000000000&max_pe=20&sector=Technology"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/portfolio-positions"

curl -X POST -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AAPL", "shares": 100, "cost_basis": 150.00}' \
  "https://www.oxfordledge.com/api/portfolio-positions"

curl -X DELETE -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AAPL"}' \
  "https://www.oxfordledge.com/api/portfolio-positions"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/etf-data?symbol=SPY"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/news/search?ticker=AAPL&days=30&limit=10"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/13f?manager=Berkshire"

curl -H "X-API-Key: $KEY" \
  "https://www.oxfordledge.com/api/bond-search?q=Apple&min_yield=4&max_duration=10"

Python SDK

The Python SDK is not yet published to PyPI — until it ships, call the REST API directly (see Authentication; any HTTP client works). The snippet below shows the planned SDK interface:

Planned usage:

from oxfordledge import OxfordLedge

client = OxfordLedge(api_key="ol_your_api_key_here")

# Get full ticker data
data = client.get_ticker("AAPL")
print(data["price"]["current"])

# Search for tickers
results = client.search("semiconductor")

# Get portfolio positions
portfolio = client.get_portfolio()

# Screen stocks
matches = client.screen(min_mcap=1e10, max_pe=20, sector="Technology")

# Search news
news = client.search_news(ticker="AAPL", days=30)

# Point-in-time fundamentals
pit = client.fundamentals_pit("MSFT", date="2025-06-30")

MCP Tools

Oxford Ledge exposes 53 tools via the Model Context Protocol (MCP), allowing Claude Desktop and other MCP clients to query financial data directly. Public-data tools work without a key; tier-gated tools need an API key (mint one under YOUR API KEYS on the dashboard — keys look like ol_live_…).

Claude Desktop Configuration

Install the package (pip install oxford-ledge-mcp), then add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "oxford-ledge": {
      "command": "oxford-ledge-mcp",
      "env": {
        "OXFORD_LEDGE_URL": "https://www.oxfordledge.com",
        "OXFORD_LEDGE_API_KEY": "ol_live_YOUR_KEY_HERE"
      }
    }
  }
}

Tool Catalog

The hosted catalog carries 53 tools; the pip package (oxford-ledge-mcp) dispatches a 13-tool subset (2 keyless SEC-EDGAR tools + 2 FRED-keyed macro tools + 9 API-key tools). The full, always-current list is machine-readable at /api/mcp/tools.json and browsable at /mcp — plan tool calls from that live list, not from a static table. Highlights (verified against the live registry 2026-08-10):

Example: Peer Comparison

Ask Claude Desktop to compare multiple tickers in a single request:

// Claude Desktop prompt:
"Compare latest-fiscal-year fundamentals for AAPL, MSFT, GOOG, and AMZN"

// Claude will call ol_peer_fundamentals with:
{
  "tickers": ["AAPL", "MSFT", "GOOG", "AMZN"]
}

Bulk Data Export

Export fundamentals, profiles, and historical prices for multiple tickers at once. Available to Investor tier and above.

Bulk Fundamentals

Examples

// Bulk fundamentals for multiple tickers (JSON)
GET /api/data/bulk?tickers=AAPL,MSFT,GOOG&fields=fundamentals

// Bulk fundamentals as CSV
GET /api/data/bulk?tickers=AAPL,MSFT&fields=fundamentals&format=csv

// Historical price data with date range
GET /api/data/bulk-history?tickers=AAPL&start=2020-01-01

// Multiple tickers with date range
GET /api/data/bulk-history?tickers=AAPL,MSFT,GOOG&start=2024-01-01&end=2024-12-31

Parameters

Additional Resources

• Machine-readable endpoint schema — JSON list of all endpoints with params
• Health check — Server status and uptime
• Data coverage — See which data sources are available for a ticker
• Pricing — Tier comparison (Learner, Researcher, Investor, Power User)