Skip to content
HowShorted

Data downloads

Every page on this site is statically generated from JSON documents produced by our ingestion pipeline. Those documents are published here unchanged, the same bytes the pages are built from, so a figure on a page and its JSON source can never disagree. No API keys, no sign-up: plain HTTP GET.

Endpoints

Three documents per market, refreshed with each daily ingest.

EU markets additionally serve /data/{market}/holders.json, every fund's full disclosure history per company, as published by the register (exit disclosures included).

Outside the US, every company page also serves its full time series as plain CSV at /{market}/company/{slug}/history.csv (columns: position_date, net_short_pct, revised; Australia's date column is trade_date). Follow the "Download CSV" link on any company page.

Each market above also has two RSS feeds: /{market}/daily.xml (one item per publication day: the day's biggest rises and falls and first-time disclosures) and /{market}/feed.xml (the weekly digest). Subscribe in any RSS reader; the RSS feeds page lists them all.

US short interest is published as pages only, with no JSON or CSV download. Every figure we hold for a US company is shown on its page. The source files are available from FINRA.

What each document contains

league.json
Every company ranked by current disclosed short position: rank, slug, issuer, ISIN, percentage, position date, and 1/5/20-trading-day changes.
movers.json
Top risers and fallers by percentage-point change over 1, 5 and 20 trading days.
site-meta.json
Dataset metadata: last updated date, day count, company count, and whether the market is in rehearsal or live mode.

Percentages are of issued share capital, as published by each regulator; we never recompute them. Every figure carries its position date (the day the position existed), which is not the day it was published. Where disclosure thresholds apply (the UK aggregate and the EU named registers), the figures are floors, not a census. Revised figures are reconciled daily; see the methodology for the exact rules, and the glossary for terms.

Use it as an API

Every JSON document, CSV and feed above is served with Access-Control-Allow-Origin: *, so browser apps can fetch them directly: no key, no proxy, no rate limit beyond fair use. URLs are stable, documents are replaced in place with each ingest, and the schema only ever gains fields. If you build something on this data, attribution with a link (previous section) is the only ask, and we would genuinely like to hear about it.

Live badges

Every non-US company has a live SVG badge at /badge/{market}/{slug}.svg showing its current short interest, refreshed with each ingest. Embed it anywhere an image goes, README files included:

Point-in-time: the day files

The archive itself is addressable: every disclosed position for every publication day, plus any recorded revisions, back to June 2010 for Australia, 2011 for France, the Netherlands and Spain,2012 for Finland and Denmark, and 2021 for Belgium (Poland's daily series starts in September 2026; see the methodology). It comes in two shapes.

Until September 2026 every day since 2010 had its own file; days older than 90 days now live in the bundles only, with identical contents. Same CORS, same stability guarantees as the documents above.

Licensing & attribution

Underlying figures are official public regulatory disclosures; our compilation is free to use with attribution, cite howshorted.com and the relevant regulator, and include the position date. Coverage runs deep: the US series reaches back to FINRA's archive start in December 2017 and keeps delisted companies' full histories (readable pages only, per the US terms below). Per-market source terms:

Suggested citation: “Short position data: [regulator], compiled by howshorted.com, position date [date].”

Ready-made building blocks

Beyond raw JSON, several pieces of the site are built to be dropped into your own page, post or dashboard as they are:

Built something on this data? Tell us at hello@howshorted.com and we will link the best examples here.