Agent402 / tools / research-company

Company research dossier

$0.10 per call · USDC via x402 · GET /api/research-company

One-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

Input

FieldTypeDescription
ticker *stringUS stock ticker, e.g. AAPL
filingsLimitnumberMax filings per form, 1-25 (default 5)
insiderDaysnumberInsider lookback window in days, 1-365 (default 90)
newsCountnumberNews headlines to return, 1-20 (default 8)

Example output

{
  "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"
  ]
}

Try it — see the 402 challenge (free)

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:

Paid call (JavaScript agent)

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).

Related tools