# 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). 8 endpoints: annual/quarterly filing summaries, insider trading signals, institutional ownership analysis, IPO/prospectus deep dives, material event analysis, forensic red flag scanning, peer comparisons, and full-text filing search. 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

## Discovery

- OpenAPI spec: https://filingspulse.vercel.app/openapi.json
- Agent discovery: https://filingspulse.vercel.app/.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?")
- 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