WhaleWisdom APIwhalewisdom.com ↗
Access the latest 13F filings, search institutional filers, and get current quarter stats via the WhaleWisdom API. Track hedge fund and institutional holdings data.
What is the WhaleWisdom API?
The WhaleWisdom API exposes 3 endpoints covering SEC 13F institutional filing data, including filer search, paginated latest filings, and current quarter statistics. The get_latest_filings endpoint returns structured filing records with fields like filer_name, period_of_report, form_type, and state, letting developers query the most recently imported 13F reports ordered by import date.
curl -X GET 'https://api.parse.bot/scraper/e670bc9c-1708-4add-a913-61585f45b8a4/get_latest_filings?page=1&rows=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace whalewisdom-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""WhaleWisdom 13F Filings — browse recent filings, search filers, check quarter stats."""
from parse_apis.whalewisdom_13f_filings_api import WhaleWisdom, Filer, FilerNotFound
client = WhaleWisdom()
# List the most recent 13F filings (capped to 5 total items).
for filing in client.filings.list(rows=10, limit=5):
print(filing.filer_name, filing.form_type, filing.period_of_report, filing.stocks_count)
# Search for a specific institutional filer by name.
filer = client.filers.search(term="Bridgewater", limit=1).first()
if filer:
print(filer.name, filer.permalink, filer.type)
# Get current quarter filing statistics.
try:
quarter = client.quarters.get()
print(quarter.quarter_description, quarter.filings_count, quarter.due_date)
for new_filer in quarter.new_filers[:3]:
print(new_filer.name, new_filer.permalink)
except FilerNotFound as exc:
print(f"Not found: {exc}")
print("exercised: filings.list / filers.search / quarters.get")
Get the most recently filed 13F reports, ordered by import date descending. Returns paginated results showing filer name, filing period, form type, state, and number of stocks in each filing. Each page returns up to rows filings; advance via page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| rows | integer | Number of filings per page, between 1 and 100. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"rows": "integer - rows per page requested",
"filings": "array of filing objects with filer_name, filer_permalink, period_of_report, filed_as_of_date, date_imported, form_type, state, stocks_count",
"total_records": "integer - total filings in database"
},
"sample": {
"data": {
"page": 1,
"rows": 10,
"filings": [
{
"state": "TN",
"form_type": "13F-HR",
"filer_name": "BRANDYWINE FINANCIAL GROUP",
"stocks_count": 36,
"date_imported": "2026-06-10 17:24:49",
"filer_permalink": "brandywine-financial-group",
"filed_as_of_date": "2026-06-10",
"period_of_report": "2026-03-31"
}
],
"total_records": 386668
},
"status": "success"
}
}About the WhaleWisdom API
Endpoints and Data Coverage
The API covers three core areas of WhaleWisdom's 13F dataset. get_latest_filings returns a paginated list of the most recently imported 13F reports. Each filing object includes filer_name, filer_permalink, period_of_report, filed_as_of_date, date_imported, form_type, state, sto, and total_records for the full result set. The rows parameter accepts values between 1 and 100, and the page parameter enables stepping through large result sets.
Filer Search
search_filers accepts a term string and returns matching filers and stocks by name — useful for autocomplete-style lookups when you know part of a firm's name, such as 'Berkshire' or 'Bridgewater'. Each result includes id, name, permalink, and type (either filer or stock), making it straightforward to resolve a human-readable name to a stable identifier for further queries.
Quarter Statistics
get_filing_quarter_stats takes no inputs and returns metadata about the current 13F filing quarter: quarter_description, due_date (in YYYY-MM-DD format), filings_count (total filings imported so far this quarter), and new_filers — an array of first-time filers with their id, name, and permalink. This is useful for monitoring filing season progress and identifying newly registered institutional filers.
The WhaleWisdom API is a managed, monitored endpoint for whalewisdom.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when whalewisdom.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official whalewisdom.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Displaying a live feed of the most recently filed 13F reports with filer name and period of report
- Building an autocomplete input to look up hedge funds or institutional filers by partial name
- Tracking how many 13F filings have been imported in the current quarter using
filings_count - Identifying first-time 13F filers each quarter via the
new_filersarray fromget_filing_quarter_stats - Mapping
filer_permalinkvalues to profile pages for institutional investors - Monitoring the 13F filing deadline date for the current quarter via
due_date - Filtering recently imported filings by form type or state using data from
get_latest_filings
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does WhaleWisdom have an official developer API?+
What does `get_latest_filings` return beyond the filer name?+
filer_permalink, period_of_report, filed_as_of_date, date_imported, form_type, state, and sto (number of stocks in the filing), along with a total_records count for the full result set. Pagination is controlled with the page and rows parameters.Does the API return the individual stock holdings within a specific 13F filing?+
How fresh is the data returned by `get_latest_filings`?+
date_imported descending, reflecting the order in which WhaleWisdom processed them. The filed_as_of_date and date_imported fields on each record let you assess both when the filer submitted to the SEC and when it appeared in the dataset.Can I retrieve historical 13F filings for a specific filer across multiple quarters?+
get_latest_filings returns recently imported filings across all filers, and search_filers resolves names to identifiers but does not return historical filing history. You can fork this API on Parse and revise it to add a per-filer historical filings endpoint using the permalink values already returned by search.