ToolVet
81trust / 100

Edgar Xbrl Frame

by EDGAR XBRL frame (cross-company in Company & people data

x402 APIPassing, checked 2 h ago

All US public companies that reported a given XBRL tag for a given period, in one call. Killer endpoint for cross-sectional screens: 'every issuer's Revenues for CY2023Q1' or 'every issuer's Assets as of CY2023Q4I (instantaneous)'. Period format: CY{YYYY} (annual), CY{YYYY}Q{1-4} (quarterly), or CY{YYYY}Q{1-4}I (instantaneous balance-sheet items). Source: data.sec.gov/api/xbrl/frames.

GET https://agent402.tools/api/edgar-xbrl-frame

Last 30 days

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

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://agent402.tools/api/edgar-xbrl-frame?period=CY2023Q1&tag=Revenues&taxonomy=us-gaap&unit=USD"
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%2Fagent402.tools%2Fapi%2Fedgar-xbrl-frame
const res = await pay("https://agent402.tools/api/edgar-xbrl-frame?period=CY2023Q1&tag=Revenues&taxonomy=us-gaap&unit=USD");
console.log(await res.json());

Example input

{
  "period": "CY2023Q1",
  "tag": "Revenues",
  "taxonomy": "us-gaap",
  "unit": "USD"
}

Example output

{
  "ccp": "CY2023Q1",
  "data": [
    {
      "accn": "0000320193-23-000064",
      "cik": 320193,
      "end": "2023-04-01",
      "entityName": "Apple Inc.",
      "loc": "US-CA",
      "val": 94836000000
    }
  ],
  "label": "Revenues",
  "returned": 1,
  "tag": "Revenues",
  "taxonomy": "us-gaap",
  "totalCompanies": 1872,
  "truncated": true,
  "uom": "USD"
}

Security scan

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

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402210 ms$0.005
7 h agoPassed402196 ms$0.005