Developer docs

REST + MCP. Free tier needs no key. Pass a paid key via x-api-key header or ?key=.

REST endpoints

GET /v1/fundamentals?ticker=AAPL&period=annual&limit=8
Full normalized statements + ratios. period = annual|quarterly. Ticker or CIK.

GET /v1/concept?ticker=MSFT&tag=Revenues
One XBRL concept time-series. Cheapest call.

GET /v1/screen?tag=Assets&period=CY2023Q4I&limit=100
Cross-sectional screener — every filer's value for a tag in a period, ranked. Paid tiers only.

GET /v1/filings?ticker=NVDA&forms=10-K,10-Q
Recent SEC filings with direct document URLs.

GET /v1/search?q=apple
Resolve a name/ticker to CIK.

Example

curl "https://edgar.dropwatchhq.com/v1/fundamentals?ticker=AAPL&period=annual&limit=4"
curl -H "x-api-key: efk_xxx" "https://edgar.dropwatchhq.com/v1/screen?tag=Revenues&period=CY2023&limit=50"

MCP (for AI agents)

Endpoint: POST https://edgar.dropwatchhq.com/mcp (JSON-RPC 2.0, streamable-http). Tools: fundamentals (paid, $0.01/call via x402), concept, screen, filings (free).

curl -s https://edgar.dropwatchhq.com/mcp -X POST -H 'content-type: application/json' \
 -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
      "params":{"name":"fundamentals","arguments":{"ticker":"AAPL"}}}'

Without payment you get a free preview + the x402 challenge inside structuredContent.x402. An x402 client (x402-fetch) signs the USDC payment and retries with an X-PAYMENT header to unlock full data.

Source & honesty

Every number comes from the SEC EDGAR XBRL APIs (data.sec.gov) — U.S. government public-domain filings. Each response includes sourceUrl so you can verify against the SEC directly. Updates are real-time as filings post (XBRL processing delay < 1 min).