xfinlink 0.8.1

Financial data API client — prices, fundamentals, entity resolution for all US equities

xfinlink

Free financial data API for US equities — prices, fundamentals, metrics, entity resolution, index constituents, and insider transactions.

Install

pip install xfinlink

Quick start

import xfinlink as xfl

xfl.set_api_key("your-key")  # or set XFINLINK_API_KEY env var
# Get a free key at https://xfinlink.com/signup

# Historical prices
df = xfl.prices("AAPL", start="2024-01-01", end="2024-12-31")
print(df[["date", "close", "adj_close", "volume"]].head())

# Multi-ticker
df = xfl.prices(["AAPL", "MSFT", "GOOGL"], start="2024-01-01")

# Financial statements
df = xfl.fundamentals("AAPL", period_type="annual")

# Computed metrics (P/E, ROE, margins, etc.)
df = xfl.metrics("AAPL", fields=["pe_ratio", "roe", "market_cap"])

# Entity resolution
info = xfl.resolve("GM")

# Search
df = xfl.search(q="apple")

# S&P 500 constituents
df = xfl.index("sp500")

# Check usage
xfl.usage()

Defaults

• start defaults to 1 year ago if omitted.
• Pagination stops at max_rows (default 10,000). Increase if you need more.
• date and period_end are regular DataFrame columns, not the index.

API endpoints

Endpoint	Use case
GET /v1/prices/{ticker}	Historical prices, volume, dividends, splits
GET /v1/fundamentals/{ticker}	Financial statements (147 fields)
GET /v1/metrics/{ticker}	37 pre-computed ratios and per-share values
GET /v1/resolve/{ticker}	Entity resolution, corporate history
GET /v1/search	Find companies by name, sector, SIC, NAICS
GET /v1/index/{name}	Index constituents (current or historical)
GET /v1/insiders/{ticker}	Insider transactions (Pro only)

Ticker endpoints accept comma-separated symbols, for example /v1/prices/AAPL,MSFT,GOOGL. Pro supports up to 100 tickers per call on data endpoints; /v1/resolve supports up to 10.

Rate limits

Free: 100/day (40/hour burst). Pro: 10,000/day (no burst). See pricing.

Links

• Docs: https://xfinlink.com/docs
• Signup: https://xfinlink.com/signup
• LLM context: https://xfinlink.com/llms.txt