API Acre · Research SEC Financial Facts

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://apiacre.com/v1/research/sec-financial-facts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "identifier": "AAPL",
    "metrics": [
      "revenue",
      "net_income",
      "total_assets",
      "diluted_eps"
    ],
    "period_type": "both",
    "periods": 4
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/research/sec-financial-facts" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"AAPL","metrics":["revenue","net_income","total_assets","diluted_eps"],"period_type":"both","periods":4}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "cik": "0000320193",
    "disclaimer": "Standardized issuer-reported XBRL facts only; verify filing context before us...",
    "entityName": "Apple Inc.",
    "metrics": {
      "revenue": {
        "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
        "description": "Revenue from contracts with customers, excluding assessed tax.",
        "label": "Revenue",
        "observations": [
          {
            "accn": "0000320193-25-000079",
            "end": "2025-09-27",
            "fy": 2025,
            "start": "2024-09-29",
            "val": 416161000000
          }
        ],
        "unit": "USD"
      }
    },
    "missingMetrics": [],
    "periodType": "both",
    "periodsPerMetric": 4,
    "retrievedAt": "2026-08-09T00:00:00Z",
    "source": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
    "taxonomy": "us-gaap"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-financial-facts",
  "version": "1"
}