81trust / 100

Edgar Concept

by edgar-concept in Markets & finance

x402 APIPassing, checked 37 min ago

Cited time-series for a single financial line-item from SEC EDGAR XBRL. Give a ticker or CIK plus a concept (a canonical name like revenue or netIncome, or a raw us-gaap tag) and get the normalized period values, each cited to its filing. Cheap granular pull.

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

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
26 ms typical, 26 ms slowest 5%
Last check
37 min 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/concept?concept=revenue&freq=annual&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%2Fconcept
const res = await pay("https://api.agentstools.dev/edgar/concept?concept=revenue&freq=annual&ticker=AAPL");
console.log(await res.json());

Example input

{
  "concept": "revenue",
  "freq": "annual",
  "ticker": "AAPL"
}

Example output

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

Security scan

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

Recent checks

WhenResultHTTPTimePrice
37 min agoPassed40226 ms$0.01
6 h agoPassed40229 ms$0.01