Home › API reference

Aegwah API reference

Paid, read-only REST API for as-filed GAAP EPS, point-in-time balance sheets, Form 4 insiders, and Exhibit 99.1 guidance. Base URL: https://api.aegwah.com. Legacy alias: /v1/asfiled still maps to /v1/actuals.

Authentication

Pass your membership key on every request. The same key unlocks the bulk ZIP (/api/download) and all /v1 modules.

Authorization: Bearer <your-api-key>

Inactive or refunded keys return 403 subscription_inactive. Rate limit: 120 requests / minute / key.

Tiers

Basic keys hitting Pro routes return 403 insufficient_tier.

Earnings actuals (/v1/actuals)

Query parameters (/earnings/:ticker)

Example

curl -fsSL -H "Authorization: Bearer $KEY" \
  "https://api.aegwah.com/v1/actuals/earnings/NVDA?from=2020-01-01"

Response envelope

{
  "ticker": "NVDA",
  "entity_name": "NVIDIA CORP",
  "cik": "1045810",
  "data_version": "1",
  "count": 24,
  "records": [ /* field dictionary below */ ]
}

Response header: X-Aegwah-Data-Version — treat as a cache key; refresh when it changes.

Record fields (actuals)

Insiders — Form 4 (/v1/insiders)

Insider record fields

transaction_type (P/S), person_name, role, transaction_date, filed_date, shares, price_per_share, shares_owned_after, edgar_accession, edgar_filing_url.

Guidance — Exhibit 99.1 (/v1/guidance)

Raw management revenue guidance mined from 8-K EX-99.1 — not street consensus.

Primary fields: guidance_revenue_midpoint or guidance_revenue_low / guidance_revenue_high, plus edgar_accession, edgar_exhibit_url, source_excerpt.

Balance sheet — point-in-time (/v1/balance)

Basic-tier balance-sheet facts from the same SEC companyfacts XBRL as earnings. Join on (ticker, fiscal_period_end). Missing tags are JSON null (never zeroed).

Query: from / to on fiscal_period_end (same as earnings). Fields: total_assets, total_liabilities, stockholders_equity, current_assets, current_liabilities, long_term_debt, short_term_debt, cash_and_equivalents, shares_outstanding, dividends_paid, plus announcement timing and edgar_accession / edgar_filing_url.

curl -fsSL -H "Authorization: Bearer $KEY" \
  "https://api.aegwah.com/v1/balance/NVDA?from=2020-01-01"

Bulk ZIP

Same membership: claim/download via /api/download. Free sample (no key): https://api.aegwah.com/api/sample.

Minimal Python client

import os, requests

BASE = "https://api.aegwah.com"
KEY = os.environ["AEGWAH_API_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def earnings(ticker: str, start: str | None = None) -> list[dict]:
    params = {}
    if start:
        params["from"] = start
    r = requests.get(
        f"{BASE}/v1/actuals/earnings/{ticker}",
        headers=H, params=params, timeout=30,
    )
    r.raise_for_status()
    return r.json()["records"]

def balance(ticker: str, start: str | None = None) -> list[dict]:
    params = {"from": start} if start else {}
    r = requests.get(
        f"{BASE}/v1/balance/{ticker}",
        headers=H, params=params, timeout=30,
    )
    r.raise_for_status()
    return r.json()["records"]

Product pages: GAAP EPS API · Balance sheet API · Form 4 API · Backtest actuals