# Filedge — Financial Document Intelligence API

## Overview
Filedge parses SEC financial filings and earnings call transcripts into structured JSON for agent consumption.
All endpoints require x402 micropayment in USDC on Base mainnet (eip155:8453).

## Endpoint
POST https://filedge.io/v1/parse
Price: $0.05 USDC per request

## Request Body
{
  "source": "edgar",        // edgar | transcript | url
  "type": "10-Q",            // 10-Q | 10-K | 8-K | form4 (required for edgar)
  "ticker": "AAPL",          // stock ticker symbol
  "period": "latest"         // latest | YYYY-QN | YYYY
}

## Supported Document Types
- 10-Q: Quarterly earnings (revenue, net income, EPS, segments, guidance, risk flags)
- 10-K: Annual report
- 8-K: Material events (earnings releases, officer changes, acquisitions)
- form4: Insider trades (transactions, summary signal)
- transcript: Earnings call (tone, topics, forward signals, analyst Q&A)

## Example Call
```bash
npx awal x402 pay "https://filedge.io/v1/parse" --method POST --data '{"source":"edgar","type":"10-Q","ticker":"AAPL","period":"latest"}'
```

## Example Response
```json
{
  "meta": {
    "ticker": "AAPL",
    "company": "Apple Inc.",
    "document_type": "10-Q",
    "period_end": "2025-03-29",
    "filed_date": "2025-05-02"
  },
  "financials": {
    "revenue_usd_cents": 9535900000000,
    "net_income_usd_cents": 2478000000000,
    "eps_diluted": 1.65
  },
  "segments": [
    {"name": "iPhone", "revenue_usd_cents": 4684100000000},
    {"name": "Services", "revenue_usd_cents": 2664500000000}
  ],
  "guidance": {"provided": false},
  "risk_flags": [
    {"flag": "regulatory", "severity": "medium", "text": "Digital Markets Act compliance may affect services distribution in the EU."}
  ]
}
```

## Response
Structured JSON with typed fields. All monetary values in USD cents (integer).

## Payment
Protocol: x402 v2
Network: eip155:8453 (Base mainnet)
Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Amount: 50000 (= $0.05)
PayTo: 0xa98E17D26e1B3A51A10C79c2F52f78914E7D50EB