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
startdefaults to 1 year ago if omitted.- Pagination stops at
max_rows(default 10,000). Increase if you need more. dateandperiod_endare 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 |
GET /v1/metrics/{ticker} |
Pre-computed financial metrics |
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/index/{name}/events |
Index additions and removals as a dated event log |
GET /v1/insiders/{ticker} |
Insider transactions (paid plans) |
Ticker endpoints accept comma-separated symbols, for example /v1/prices/AAPL,MSFT,GOOGL. Tickers per call on data endpoints scale by plan: 1 (Free), 100 (Pro), 500 (Business), 1,000 (Redistribution); /v1/resolve supports up to 10.
Rate limits
Requests per day: Free 100 (40/hour burst), Pro 10,000, Business 50,000, Redistribution 100,000. Only the Free tier is throttled per hour. Paid plans also unlock full history (daily prices back to 1996, fundamentals back to 1950). See pricing.
Links
- Docs: https://xfinlink.com/docs
- Signup: https://xfinlink.com/signup
- LLM context: https://xfinlink.com/llms.txt
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xfinlink-0.10.0.tar.gz.
File metadata
- Download URL: xfinlink-0.10.0.tar.gz
- Upload date:
- Size: 17.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19c47ec8010eb606a8e734cf0cf4f778542ce7efd1cc2cfee3df072f9f8897bd
|
|
| MD5 |
d283d7fd06e67d199714aaaa65a01991
|
|
| BLAKE2b-256 |
b8791f07b85f8d251fe3ea48372e0db5b6f17b2a6bd22c39b9d7a8fc4f8520c5
|
File details
Details for the file xfinlink-0.10.0-py3-none-any.whl.
File metadata
- Download URL: xfinlink-0.10.0-py3-none-any.whl
- Upload date:
- Size: 16.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
91d0503445e5c5427a4a9062dd9f5473556d72f664248c1cd562a0591feee3d8
|
|
| MD5 |
5e1c2865803e706026212098d1118c91
|
|
| BLAKE2b-256 |
2c638b76a5ea2e3604f3a341586ea87fb2594bc7c051fb54ccc1fdf285e1d282
|
