HTTP/1.1 402 PAYMENT REQUIRED agent402.base.eth · BASE · SOLANA · POLYGON · ARBITRUM · MONAD · CELO · AVALANCHE · SEI · OPTIMISM · STELLAR · ALGORAND · ROBINHOOD · USDC · USDG
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).

Part of these workflows

This tool is one step in a curated multi-tool workflow - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.

Related tools

agent demand radar

$0.005 · GET /api/demand-radar

What agents want that no one is serving yet - the paid intelligence layer over Agent402's agent-demand board, for x402 s…

Agent402 bestsellers

$0.005 · GET /api/bestsellers

What agents actually pay for on a 500+ tool x402 catalog - the paid intelligence layer over Agent402's own sales ledger,…