81trust / 100

Edgar Financials

by edgar-financials in Markets & finance

x402 APIPassing, checked 5 h ago

Normalized company financials from SEC EDGAR XBRL filings. Give a ticker or CIK and get income statement, balance sheet and cash flow lines mapped to one clean schema, each value cited to its real XBRL tag and filing. Compact cited JSON instead of megabytes of raw XBRL.

GET https://api.agentstools.dev/edgar/financials

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
26 ms typical, 26 ms slowest 5%
Last check
5 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://api.agentstools.dev/edgar/financials?freq=annual&periods=5&ticker=AAPL"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.agentstools.dev%2Fedgar%2Ffinancials
const res = await pay("https://api.agentstools.dev/edgar/financials?freq=annual&periods=5&ticker=AAPL");
console.log(await res.json());

Example input

{
  "freq": "annual",
  "periods": 5,
  "ticker": "AAPL"
}

Example output

{
  "attribution": "SEC EDGAR (public domain); data.sec.gov XBRL frames API",
  "entity": {
    "cik": "0000320193",
    "name": "Apple Inc.",
    "ticker": "AAPL"
  },
  "found": true,
  "freq": "annual",
  "restatements": [],
  "statements": {
    "income": [
      {
        "label": "Revenue",
        "line": "revenue",
        "periods": [
          {
            "filing": {
              "accn": "0000320193-24-000123",
              "filed": "2024-11-01",
              "form": "10-K",
              "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm"
            },
            "period": {
              "end": "2024-09-28",
              "fp": "FY",
              "frame": "CY2024",
              "fy": 2024,
              "start": "2023-10-01"
            },
            "restated": false,
            "unit": "USD",
            "value": 391035000000
          }
        ],
        "sourceTag": "RevenueFromContractWithCustomerExcludingAssessedTax",
        "unit": "USD"
      }
    ]
  }
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
5 h agoPassed40226 ms$0.03