Guides

Runnable recipes for the API. Every one of them works on the free Community tier, so you can paste it into a terminal and watch it return real filings. Python, no boilerplate, no signup wall.

By datasetInstitutional holdings Insider transactions Beneficial ownership Fund portfolios

Start here

Export a fund's 13F portfolio to CSV

Pull a manager's latest 13F filing and write every position to a CSV you can open in a spreadsheet, without losing precision on the dollar values. Python, on a free key.

Institutional holdings

Read the guide

import csv
import itertools
from decimal import Decimal
from py3spread import Client
MANAGER_CIK = "1067983"  # Berkshire Hathaway

Insider transactions

Build an insider trading screener in Python

Pull every Form 4 insider transaction for a ticker, measure buy/sell sentiment, and rank the largest trades. About 30 lines of Python against a free API key.

from decimal import Decimal
from py3spread import Client
TICKER = "AAPL"
with Client() as client:
    ratio = client.insiders.buy_sell_ratio(ticker=TICKER, window_days=90)

Beneficial ownership

Track activist investors with 13D and 13G filings

Pull Schedule 13D and 13G filings for a company, tell activist stake-building apart from passive index ownership, and read the reporting persons behind a stake. Python, on a free key.

import itertools
from py3spread import Client
TICKER = "AAPL"
with Client() as client:
    filings = list(itertools.islice(client.beneficial_ownership.iter(ticker=TICKER), 10))

Fund portfolios

See what a fund actually holds (N-PORT look-through)

Find a fund family by name, then pull its largest reported positions from Form N-PORT, with each position's weight in the fund. Python, on a free key.

import itertools
from decimal import Decimal
from py3spread import Client
SEARCH = "vanguard"
with Client() as client:

Institutional holdings

Find every institution holding a stock (13F, in Python)

Use 13F filings to list the largest institutional positions in a security, ranked by dollar value, then drill into a single manager's filing history. Runs on a free API key.

import itertools
from decimal import Decimal
from py3spread import Client
CUSIP = "037833100"  # Apple
with Client() as client:

Get Started

Choose the path that fits your needs.

Browse the datasets

Eleven filing families, and what is in each.

See datasets

Get a free key

10,000 requests per day, every dataset, no credit card.

Read the docs

Every endpoint, parameter, and response schema.

Open Docs