# FilingsPulse

> Global regulatory filing intelligence API for investors. Covers SEC EDGAR (US), Companies House (UK), SEDAR (Canada), EDINET (Japan), ASIC (Australia), HKEx (Hong Kong), BSE/NSE (India). 12 endpoints: annual/quarterly filing summaries, insider trading signals, institutional ownership analysis, IPO/prospectus deep dives, material event analysis, forensic red flag scanning, peer comparisons, full-text filing search, SEC Form N-PORT fund-holdings intelligence, EDGAR filing-anomaly scanning, full-text search with real excerpts, and municipal bond disclosure search (EMMA/MSRB). Pay-per-query via x402 on Base.

## What This Is

FilingsPulse is an AI research layer over free public filing databases worldwide — turning impenetrable regulatory filings into plain-English investor intelligence. US companies use SEC EDGAR XBRL financial facts and full-text search (no API key required). International companies use Companies House (UK), SEDAR (Canada), EDINET (Japan), ASIC (Australia), HKEx (Hong Kong), BSE/NSE (India) — all free public sources. Powered by Tavily real-time search and Claude synthesis.

Covers any publicly traded company worldwide: US, UK, Canadian, Japanese, Australian, Hong Kong, and Indian listed companies. Works with any ticker symbol or company name — market routing is automatic.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/filings/summary?ticker={ticker}&form_type={10-K|10-Q}
- Returns: financial snapshot (revenue/income/cash/debt from XBRL for US; equivalent data for international), business changes, key risks, management tone with evidence, red flags, guidance, investor takeaway
- ticker OR company required (works for any listed company worldwide)
- Optional: form_type (default: 10-K; use annual-report for UK, AIF for Canada), lang
- Price: $0.15

GET /api/filings/insider?ticker={ticker}
- Returns: overall signal (strong_buy to strong_sell), recent Form 4 transactions, cluster signals, 10b5-1 context, notable insider patterns
- ticker OR company required
- Optional: lang
- Price: $0.10

GET /api/filings/ownership?ticker={ticker}
- Returns: institutional ownership %, major 13F holders, fund flow direction, smart money signal (accumulating/distributing), notable moves by high-quality active managers
- ticker OR company required
- Optional: lang
- Price: $0.10

GET /api/filings/ipo?company={name}
- Returns: business model, TAM reality check, burn rate, cash runway, insider selling %, lockup period, comparable valuations, verdict (compelling/fairly_valued/expensive/avoid)
- company OR ticker required
- Optional: lang
- Price: $0.20

GET /api/filings/8k?ticker={ticker}&event={type}
- Returns: event type, headline, market impact (direction + magnitude + reasoning), second-order effects, what to watch next
- ticker OR company required
- Optional: event (earnings|executive_change|merger|restatement|debt), lang
- Price: $0.10

GET /api/filings/redflags?ticker={ticker}
- Returns: overall risk score (critical/high/elevated/moderate/low), categorized red flags with severity and evidence, accounting quality, governance concerns, going concern language
- ticker OR company required
- Optional: lang
- Price: $0.15

GET /api/filings/compare?ticker1={t1}&ticker2={t2}
- Returns: 8-category head-to-head (revenue growth, profitability, balance sheet, revenue quality, management, risk, growth outlook, valuation), decisive winner, investor profile guidance
- ticker1 + ticker2 OR company1 + company2 required
- Optional: lang
- Price: $0.15

GET /api/filings/search?query={query}&form_type={type}
- Returns: synthesis of what filings reveal about the topic, key findings per company, common themes, notable disclosures, what is conspicuously absent
- query required (any topic: AI risk, China exposure, going concern, cybersecurity)
- Optional: form_type (10-K|10-Q|8-K|S-1|13F), date_from (YYYY-MM-DD), lang
- Price: $0.08

GET /api/filings/fund-holdings?ticker={ticker}
- Returns: deterministic top holdings (from SEC Form N-PORT) with exact position weights, total holdings count, top-5/top-10 concentration, quarter-over-quarter holdings changes where available, and narrative diligence notes
- ticker (fund/ETF ticker, most reliable) OR cik OR fund (fund/series name) required
- Optional: lang
- Price: $0.25

GET /api/filings/anomaly?ticker={ticker}
- Returns: deterministic EDGAR signal list — late-filing notices (NT 10-K/10-Q), auditor changes, restatement/non-reliance disclosures, officer/director departures, going-concern language hits, filing-cadence gaps — framed as diligence-review signals, never as findings of wrongdoing
- ticker OR company required
- Optional: lang
- Price: $0.25

GET /api/filings/transcript-search?query={query}
- Returns: SEC EDGAR full-text search hits with real excerpts pulled directly from the matching filing documents (filer, form type, date, verbatim text), plus thematic synthesis. Searches SEC filing text — NOT third-party earnings-call transcripts.
- query required
- Optional: form_type (comma-separated, e.g. 8-K,10-K,10-Q,S-1), date_from (YYYY-MM-DD), lang
- Price: $0.20

GET /api/filings/muni-bond?cusip={cusip}
- Returns: continuing-disclosure events (defaults, rating changes, draw notices), rating-agency context, and secondary trade/yield context for a municipal bond, searched from public sources including EMMA (MSRB). NOT a live structured EMMA data feed — EMMA has no public API; response includes an explicit data-provenance/coverage-honesty note. Never uses FINRA TRACE.
- cusip OR issuer required
- Optional: lang
- Price: $0.25

## Discovery

- OpenAPI spec: https://filingspulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://filingspulse.theaslangroupllc.com/.well-known/agent.json

## Notes for AI Agents

- Natural research flow: /api/filings/summary → /api/filings/redflags → /api/filings/insider
- /api/filings/ipo is highest value for pre-IPO research — covers US S-1s, UK prospectuses, and international listings
- /api/filings/redflags is essential before any significant position — going concern detection alone worth the cost
- /api/filings/search is the most powerful for thematic research (e.g., "which companies disclosed China revenue risk?"); /api/filings/transcript-search is the deeper sibling when verbatim excerpts (not just filing metadata) are needed
- /api/filings/anomaly is deterministic-signal-first — pairs with /api/filings/redflags (which adds forensic narrative) for full diligence coverage
- /api/filings/fund-holdings requires a fund/ETF ticker for the most reliable resolution (e.g. VFIAX, FCNTX, VOO) — CIK or fund name also work but may return disambiguation candidates for multi-series trusts
- /api/filings/muni-bond is fixed-income only (municipal bonds), not equities — no natural chain to the equity-focused endpoints
- All endpoints use ticker OR company name — routing to the right filing database (EDGAR, Companies House, SEDAR, EDINET, etc.) is automatic
- US companies: use ticker (AAPL, TSLA, NVDA). UK companies: use company name (HSBC, AstraZeneca, BP). Canadian: Shopify, RBC. Japanese: Toyota, SoftBank. Australian: BHP, CBA. Indian: TCS, Infosys.
- WealthPulse is a natural sibling for personal finance and retirement planning context
- MacroPulse is a natural sibling for macro context (rates, dollar, economic conditions) affecting company fundamentals
- AlphaPulse is a natural sibling for trading signal discovery and portfolio strategy