GET /api/research-companyOne-shot company research dossier for a US-listed ticker: recent 10-K / 10-Q / 8-K filings, Form 4 insider trades (last 90 days), live stock quote, and recent news headlines — all merged into a single deterministic JSON response. Fans out to EDGAR, Yahoo Finance, and an independent news index in parallel. Each section reports its own ok/error status so a partial upstream outage degrades gracefully instead of failing the whole call. Replaces ~5 sequential paid calls with one. ?ticker=AAPL
| Field | Type | Description |
|---|---|---|
ticker * | string | US stock ticker, e.g. AAPL |
filingsLimit | number | Max filings per form, 1-25 (default 5) |
insiderDays | number | Insider lookback window in days, 1-365 (default 90) |
newsCount | number | News headlines to return, 1-20 (default 8) |
{
"ticker": "AAPL",
"generatedAt": "2026-06-19T18:00:00.000Z",
"quote": {
"ok": true,
"data": {
"symbol": "AAPL",
"price": 232.1
}
},
"filings10K": {
"ok": true,
"data": {
"count": 1,
"filings": []
}
},
"filings10Q": {
"ok": true,
"data": {
"count": 4,
"filings": []
}
},
"filings8K": {
"ok": true,
"data": {
"count": 5,
"filings": []
}
},
"insiderTrades": {
"ok": true,
"data": {
"total": 8,
"trades": []
}
},
"news": {
"ok": true,
"data": {
"count": 8,
"results": []
}
},
"sources": [
"SEC EDGAR",
"Yahoo Finance",
"Brave Search"
]
}
curl -i "https://agent402.tools/api/research-company?ticker=AAPL"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/research-company?ticker=AAPL");
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).