# OmniNexu — Agent Data Intelligence
# Anonymous analytics: omninexu.com/api/stats

> Machine-readable catalog. Agents: read this first.
> Humans: https://omninexu.com

## Discovery Files

| File | Purpose |
|------|---------|
| `/llms.txt` | This file — AI agent quick reference |
| `/robots.txt` | AI crawler allowlist |
| `/sitemap.xml` | Site structure for crawlers |
| `/api/stats` | Anonymous visit analytics |

## What We Provide

OmniNexu delivers **structured, traceable financial intelligence** for AI agents.
8 API endpoints across 3 pricing tiers ($0.01–$0.05 USDC), all payable via x402
on Base mainnet — no API key, no signup, no human in the loop.

**Coverage**: S&P 500 constituents (NYSE, NASDAQ, AMEX). 440+ tickers with
full fundamentals, expanding to 500.

**Data**: SEC EDGAR is the **authoritative source** for latest-year data (10-K,
10-Q, Form 4, 13F). SimFin provides **standardized historical** records
(FY2020–present) for longitudinal analysis. Every data point is traceable to
a specific SEC filing by CIK + accession number.

**Differentiators**:
- Cross-source validation (SimFin vs EDGAR) with defined confidence scoring
- Peer comparison ranking within GICS sub-industry — unique on agentic.market
- Multi-year CAGR growth trends — unique on agentic.market
- Smart Money bundle (insider + institutional in one call)
- Real SEC EDGAR data — not mock, not synthetic, not scraped
- Open source: github.com/fut66663/omninexu-v1 (Apache 2.0)

## Products — 8 Endpoints, 3 Tiers

### Quick Tier
| Endpoint | Price | Description |
|----------|-------|-------------|
| `GET /v1/company/context?ticker=AAPL` | $0.05 | Fundamentals (9 metrics) + peer comparison + confidence score |
| `GET /v1/company/filings?ticker=AAPL` | $0.01 | Recent SEC filings — 10-K, 10-Q, 8-K with source URLs |
| `GET /v1/company/peer-ranking?ticker=AAPL` | $0.02 | Industry peer ranking — revenue & net income position |

### Standard Tier
| Endpoint | Price | Description |
|----------|-------|-------------|
| `GET /v1/company/pulse?ticker=AAPL` | $0.02 | Investment signals — insider, institutional, revenue trend |
| `GET /v1/company/insider?ticker=AAPL` | $0.03 | SEC Form 4 insider transactions — buys/sells, cluster detection |
| `GET /v1/company/institutional?ticker=AAPL` | $0.03 | SEC 13F institutional holdings — top fund positions |

### Premium Tier
| Endpoint | Price | Description |
|----------|-------|-------------|
| `GET /v1/company/smart-money?ticker=AAPL` | $0.05 | Bundle: insider trades + institutional holdings in one call |
| `GET /v1/company/longitudinal?ticker=AAPL` | $0.03 | Multi-year CAGR — revenue, net income, EPS, operating income, cash flow |

## Data Sources & Attribution

Every response includes a `sources` array with filing URLs. Each data point
is traceable to a specific SEC filing by CIK + accession number.

### Source Hierarchy

| Data Dimension | Primary Source | Secondary | Update Cycle |
|----------------|---------------|-----------|-------------|
| Fundamentals (latest year) | SEC EDGAR 10-K | SimFin | Daily |
| Fundamentals (historical 3Y+) | SimFin FY2020–present | SEC EDGAR XBRL | Weekly |
| Insider Trading | SEC EDGAR Form 4 | — | Daily |
| Institutional Holdings | SEC EDGAR 13F-HR | — | Quarterly |
| Peer Comparison | SEC EDGAR + GICS | — | Daily |
| Longitudinal CAGR | SimFin + SEC EDGAR | — | Weekly |

### Cross-Validation

SimFin vs EDGAR discrepancy detection on 9 core concepts:
- Discrepancy < 2% → confidence: "high"
- Discrepancy 2–10% → confidence: "medium" + warning flag
- Discrepancy > 10% → confidence: "low" + critical flag
- Either source missing → confidence: "medium"

### Traceability (Roadmap)

Each financial fact will include:
- `source_filing`: 10-K, 10-Q, Form 4, or 13F-HR
- `source_url`: Direct link to sec.gov filing
- `cik`: Company CIK number
- `accession`: SEC accession number
- `fiscal_year` + `fiscal_period`: Reporting period
- (Future) `page_number`: Specific page/section in the filing

## Pricing

| Tier | Price | Endpoints |
|------|-------|-----------|
| **Quick** | $0.01–$0.05 USDC | context · filings · peer-ranking |
| **Standard** | $0.02–$0.03 USDC | pulse · insider · institutional |
| **Premium** | $0.03–$0.05 USDC | smart-money (bundle) · longitudinal (CAGR) |

Payment via **x402 protocol** on Base mainnet. No API key, no signup.
Buyer pays **zero gas** — CDP Facilitator sponsors all on-chain fees.

## Payment Flow

```
1. Agent requests data
   → HTTP 402 + PAYMENT-REQUIRED header (amount, network, payTo)

2. Agent signs with x402 SDK
   → EIP-3009 off-chain signature (no gas, no native token needed)

3. Agent retries with payment proof
   → CDP Facilitator verifies → settles USDC on Base → 200 + data
```

Wallet-to-wallet, instant settlement. No API key, no signup.

## Coverage

| Metric | Count |
|--------|------:|
| S&P 500 constituents | 500 |
| Full fundamentals | 440 tickers (88%) |
| Peer comparison | 500 companies |
| Insider trading (Form 4) | 18 tickers |
| Institutional holdings (13F) | 20 tickers |
| Financial facts in database | 16,746 |
| Data管道每日更新 | SEC EDGAR direct |

## API

Base URL: `https://api.omninexu.com`

```bash
# Health check (free)
curl https://api.omninexu.com/v1/health

# Company context
curl "https://api.omninexu.com/v1/company/context?ticker=AAPL"

# Exclude peer comparison
curl "https://api.omninexu.com/v1/company/context?ticker=AAPL&include_peers=false"
```

## Contact

Email: omninexu@outlook.com
Domain: omninexu.com