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.

Include your API key in the X-API-Key header with every request:

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

# Using Python requests
import requests

headers = {"X-API-Key": "ol_your_api_key_here"}
r = requests.get("https://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://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://oxfordledge.com/api/ticker-search?q=apple"

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

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

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

curl -H "X-API-Key: $KEY" \
  "https://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://oxfordledge.com/api/portfolio-positions"

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

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

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

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

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

Python SDK

Install the Oxford Ledge Python SDK for convenient access to all endpoints:

pip install oxfordledge

Basic 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 38 tools via the Model Context Protocol (MCP), allowing Claude Desktop and other MCP clients to query financial data directly. Tools are read-only and require no API key when run locally.

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "oxford-ledge": {
      "command": "python",
      "args": ["/path/to/oxford-ledge/mcp_server.py"]
    }
  }
}

Market Data

Company Analysis

Fixed Income & Credit

News & Calendar

Portfolio

Education

Screening & Batch

Example: Batch Tool Usage

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

// Claude Desktop prompt:
"Compare the valuation metrics for AAPL, MSFT, GOOG, and AMZN"

// Claude will call batch_get_ticker_data with:
{
  "tickers": ["AAPL", "MSFT", "GOOG", "AMZN"],
  "fields": "price,metrics"
}

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)