Datavidence Financials

Normalized US-GAAP financial statements from SEC EDGAR — auditable, point-in-time, and trivial to integrate.

What you get

Three statementsIncome statement, balance sheet, and cash flow — normalized into one fixed JSON schema, no cleaning required.

Point-in-timePass as_of to get figures as originally reported on that date — no look-ahead bias in backtests.

Per-value provenanceEvery number links back to its SEC filing (accession + filed date + a direct EDGAR URL) with include_provenance.

Computed ratiosMargins, ROA/ROE, and leverage with include_ratios — derived only from the statements in the same response.

Base URL & authentication

https://financial-ledgers.api.deaddroparchives.com

Authenticate with an X-API-Key header on every request. Errors use a standard { "status": "error", "error": { "code", "message" } } envelope, and every response carries X-RateLimit-Limit / Remaining / Reset.

Try it now — no signup. Use the public sandbox key sandbox_demo_key as your X-API-Key. It returns a fixed sample dataset (a fictional company's FY2023 filing) without consuming quota or hitting SEC, so you can wire up integration before subscribing. All parameters — as_of, include_provenance, include_ratios — work against it.

Quickstart

cURL

curl -H "X-API-Key: sandbox_demo_key" \
  "https://financial-ledgers.api.deaddroparchives.com/v1/extract-ledger?ticker=AAPL&year=2023&include_ratios=true"

Python

import requests

BASE = "https://financial-ledgers.api.deaddroparchives.com"
headers = {"X-API-Key": "sandbox_demo_key"}  # swap for your key

r = requests.get(
    f"{BASE}/v1/extract-ledger",
    params={"ticker": "AAPL", "year": 2023, "include_ratios": True},
    headers=headers, timeout=30,
)
r.raise_for_status()
data = r.json()["data"]
print(data["income_statement"]["total_revenue"], data["ratios"]["net_margin"])

Node.js (18+)

const BASE = "https://financial-ledgers.api.deaddroparchives.com";
const url = new URL(BASE + "/v1/extract-ledger");
url.search = new URLSearchParams({ ticker: "AAPL", year: "2023", include_provenance: "true" });

const res = await fetch(url, { headers: { "X-API-Key": "sandbox_demo_key" } });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data } = await res.json();
console.log(data.income_statement.total_revenue, data.provenance.income_statement.total_revenue.source_url);

Go

req, _ := http.NewRequest("GET",
    "https://financial-ledgers.api.deaddroparchives.com/v1/extract-ledger?ticker=AAPL&year=2023", nil)
req.Header.Set("X-API-Key", "sandbox_demo_key")
resp, err := http.DefaultClient.Do(req)
// ... check err, resp.StatusCode, then json.Decode(resp.Body)

Endpoints

GET /v1/extract-ledger normalized three-statement financials for a fiscal year.
GET /v1/submissions trimmed SEC submissions index (recent filings).
GET /v1/usage your current quota — free, doesn't consume a request.
Full schemas in the API reference.

Disclaimer

This API provides information derived from public SEC EDGAR filings on an “as is” and “as available” basis, for informational purposes only. It is not investment, financial, legal, tax, or accounting advice, and must not be relied upon as the basis for any trading, investment, or compliance decision. No warranty is made as to the accuracy, completeness, timeliness, or fitness for a particular purpose of any data. You are responsible for verifying figures against the original SEC filings (use the provenance source_url) and for any decisions or automated/algorithmic use, which are entirely at your own risk. Sample/sandbox data is fictional and for integration testing only.