How do I bulk-export fund data for a whole universe?

Export on Scale

bash
curl -s "https://fundfactsapi.com/api/v1/export?issuer=ishares&assetClass=Equities&gzip=1" -H "Authorization: Bearer $FUNDFACTS_API_KEY" \
  | gunzip | head -n 2 | jq '{isin, name, ter: .data.headlineMetrics.ter}'

Filters: issuer, assetClass, currency, since (payloads generated after this date). Each line is the same envelope as GET /funds/{isin}. One request per call regardless of size.

Seeding the universe

The export returns what is in the store. To cover a universe:

1. Build the ISIN list (your own, or from the coverage pages and GET /search).
2. Load it with POST /funds in batches of the plan size with wait: true; re-send pending entries after a minute.
3. Repeat daily for the ISINs whose expiresAt has passed; on Scale, or Pro with overage, that is one request per ISIN per day.

On Pro

python
import os, requests, json, time
H = {"Authorization": f"Bearer {os.environ['FUNDFACTS_API_KEY']}"}
isins = [l.strip() for l in open("universe.txt") if l.strip()]
with open("funds.ndjson", "a") as out:
    for i in range(0, len(isins), 50):
        r = requests.post("https://fundfactsapi.com/api/v1/funds", json={"isins": isins[i:i+50], "wait": True}, headers=H, timeout=300).json()
        for x in r["results"]:
            if x["status"] == "ok":
                out.write(json.dumps(x) + "\n")
            elif x["status"] == "pending":
                isins.append(x["isin"])  # try again at the end
        time.sleep(1)

Keeping it current

Pair the export with the change feed to update only the funds whose tracked fields moved, rather than re-exporting everything. The quant research use case covers the analysis side.