API Acre · Research SEC Company Evidence

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-company-evidence", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "filing_lookback_days": 365,
    "financial_metrics": [
      "revenue",
      "net_income",
      "total_assets",
      "diluted_eps"
    ],
    "financial_period_type": "both",
    "financial_periods": 4,
    "forms": [
      "10-K",
      "10-Q",
      "8-K"
    ],
    "identifier": "Apple Inc.",
    "include_derivatives": true,
    "insider_lookback_days": 90,
    "max_filings": 25,
    "max_insider_filings": 5
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/research/sec-company-evidence" \
  -H "Content-Type: application/json" \
  -d '{"filing_lookback_days":365,"financial_metrics":["revenue","net_income","total_assets","diluted_eps"],"financial_period_type":"both","financial_periods":4,"forms":["10-K","10-Q","8-K"],"identifier":"Apple Inc.","include_derivatives":true,"insider_lookback_days":90,"max_filings":25,"max_insider_filings":5}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "company": {
      "cik": "0000320193",
      "exchanges": [
        "Nasdaq"
      ],
      "name": "Apple Inc.",
      "tickers": [
        "AAPL"
      ]
    },
    "coverage": {
      "availableSectionCount": 3,
      "partial": false,
      "requestedSectionCount": 3,
      "sections": {
        "filingActivity": "available",
        "financialFacts": "available",
        "insiderTransactions": "available"
      }
    },
    "disclaimer": "Official SEC evidence normalized for research only; not i...",
    "filingActivity": {
      "data": {
        "attentionScore": 5,
        "cik": "0000320193",
        "filingCount": 5,
        "name": "Apple Inc."
      },
      "status": "available"
    },
    "financialFacts": {
      "data": {
        "cik": "0000320193",
        "entityName": "Apple Inc.",
        "metrics": {
          "revenue": {
            "observations": [
              {
                "end": "2025-09-27",
                "filed": "2025-10-31",
                "form": "10-K",
                "val": 416161000000
              }
            ],
            "unit": "USD"
          }
        },
        "taxonomy": "us-gaap"
      },
      "status": "available"
    },
    "insiderTransactions": {
      "data": {
        "cik": "0000320193",
        "includeDerivatives": true,
        "lookbackDays": 90,
        "name": "Apple Inc."
      },
      "status": "available"
    },
    "limitations": [
      "Coverage is bounded by the requested lookback periods, fi...",
      "Issuer filings can be amended, restated, delayed, incompl...",
      "Form 4 transaction codes and footnotes require contextual..."
    ],
    "parameters": {
      "filingLookbackDays": 365,
      "financialMetrics": [
        "revenue",
        "net_income",
        "total_assets",
        "diluted_eps"
      ],
      "forms": [
        "10-K",
        "10-Q",
        "8-K"
      ],
      "maxFilings": 25
    },
    "resolution": {
      "method": "company_name_exact",
      "query": "Apple Inc.",
      "resolvedCik": "0000320193",
      "usedListedCompanyDirectory": true
    },
    "retrievedAt": "2026-08-12T00:00:00Z",
    "sources": [
      "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193....",
      "https://data.sec.gov/submissions/CIK0000320193.json",
      "https://www.sec.gov/files/company_tickers_exchange.json"
    ],
    "warnings": []
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.sec-company-evidence",
  "version": "1"
}