# Key metrics API: pay per call with x402

> Key metrics API for AI agents: key metrics (revenue, net income, diluted EPS, operating cash flow, cash) from official sources, $0.006 per call in USDC on Base with x402. No account or API key.

Pay per call for key metrics (revenue, net income, diluted EPS, operating cash flow, cash) with [x402](/pricing/): no account and no API key. An x402 client gets a `402 Payment Required` answer with the price, pays in USDC on Base, and repeats the request.

## `GET /v1/companies/{id}/metrics`

**$0.006 per call** in USDC on Base. Returns five headline figures for a company (revenue, net income, diluted EPS, operating cash flow, cash and equivalents) as annual and quarterly series, newest period first. Each figure names the SEC filing it comes from and the first filing that reported it; a quarter computed from two filed figures names both filings. Charged only when at least one record comes back; errors and empty results are free.

Free for the demo companies, with no key and no payment (up to 60 an hour per network):

```bash
curl "https://api.belfortagent.xyz/v1/companies/AAPL/metrics?metric=revenue&frequency=annual"
```

Any other company answers `402 Payment Required` until paid:

```bash
curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/metrics?metric=revenue&frequency=annual"
```

The `PAYMENT-REQUIRED` header, base64-decoded (trimmed to the payment terms):

```json
{
  "x402Version": 2,
  "resource": {
    "url": "https://api.belfortagent.xyz/v1/companies/NVDA/metrics?metric=revenue&frequency=annual"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "6000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x80bEF165f2895539CfEcd74A7949A88e576e5E09",
      "maxTimeoutSeconds": 60
    }
  ]
}
```

## Details

- Every field, parameter and error: [Key metrics](/datasets/metrics/).
- Machine-readable: the API's [OpenAPI document](https://api.belfortagent.xyz/openapi.json) (`x-payment-info` on each paid route) and [`/.well-known/x402`](https://api.belfortagent.xyz/.well-known/x402).
- With an API key and card credits instead: [Pricing](/pricing/).

---
Source: https://docs.belfortagent.xyz/x402/metrics/
