# GET /us/company/financials: $0.01 per call

Headline financials of any SEC-registered company by ticker, CIK or name, as filed: revenue, gross/operating/net income, EPS, assets, liabilities, equity, cash, operating cash flow, capex, free cash flow and margins, for the last 1–10 years or quarters. Pass ?company=AAPL&period=annual&periods=4. From SEC EDGAR XBRL; missing figures are null, never estimated.

- **Price:** $0.01 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Answers cached for:** 6 hour(s)
- **Data sources:** SEC EDGAR XBRL API (free, public domain)
- **Lane:** Company financials & money ([OpenAPI](/openapi/finance.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/us-company-financials](/sample/us-company-financials). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/us-company-financials"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/us/company/financials?company=AAPL&period=annual&periods=2"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/us/company/financials?company=AAPL&period=annual&periods=2");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("us-company-financials", {"company":"AAPL","period":"annual","periods":2});
```

## Inputs

- `company` **(required)** (string): Ticker (AAPL, BRK.B), SEC CIK number (320193) or company name (Apple).
- `period` (string; one of `annual`, `quarterly`; default `annual`): Fiscal years or quarters.
- `periods` (integer; default `4`): How many recent periods, newest first.

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

Example only: the shape of an answer, with placeholder addresses and made-up figures. It is not data about any real token or wallet; call the service (or its free sample) for real results.

```json
{
  "company": {
    "name": "Apple Inc.",
    "cik": 320193,
    "tickers": [
      "AAPL"
    ],
    "exchanges": [
      "Nasdaq"
    ]
  },
  "period": "annual",
  "currency": "USD",
  "taxonomy": "us-gaap",
  "periods": [
    {
      "start": "2024-09-29",
      "end": "2025-09-27",
      "fiscalYear": 2025,
      "fiscalPeriod": "FY",
      "form": "10-K",
      "filed": "2025-10-31",
      "filing": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
      "revenue": 416161000000,
      "grossProfit": 195201000000,
      "operatingIncome": 133050000000,
      "netIncome": 112010000000,
      "epsBasic": 7.49,
      "epsDiluted": 7.46,
      "totalAssets": 359241000000,
      "totalLiabilities": 285508000000,
      "equity": 73733000000,
      "cash": 35934000000,
      "operatingCashFlow": 111482000000,
      "capex": 12715000000,
      "freeCashFlow": 98767000000,
      "grossMarginPct": 46.9,
      "operatingMarginPct": 32,
      "netMarginPct": 26.9,
      "derived": [
        "freeCashFlow = operatingCashFlow − capex"
      ]
    }
  ],
  "sharesOutstanding": {
    "value": 14594180000,
    "asOf": "2026-07-17"
  },
  "conceptsUsed": {
    "revenue": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
    "netIncome": "us-gaap:NetIncomeLoss"
  },
  "note": "As filed with the SEC (XBRL), latest restatement first; null means the company did not tag that figure for the period. Not investment advice.",
  "source": "SEC EDGAR XBRL company facts (data.sec.gov), public domain"
}
```

## Related

- [GET /us/company/filings](/services/us-company-filings) ($0.005): Latest SEC filings of any US-registered company by ticker, CIK or name: 10-K, 10-Q, 8-K (items spelled out, e.g.
- [GET /convert/crypto](/services/crypto-convert) ($0.001): Convert between crypto and fiat at live rates: BTC, ETH, SOL, USDC and hundreds more against USD, GBP, EUR and 150+ currencies, either way, or crypto to crypto.
- [GET /iban/check](/services/iban-check) ($0.001): Validate an IBAN before you pay: check digits (mod-97), the right length for its country, SEPA membership, and the bank code, branch and account parts (UK: sort

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).