# Earnings releases API: pay per call with x402

> Earnings releases API for AI agents: earnings releases (8-K Item 2.02 exhibits) from official sources, $0.018 or $0.03 per call in USDC on Base with x402. No account or API key.

Pay per call for earnings releases (8-K Item 2.02 exhibits) 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}/earnings-releases`

**$0.018 per call** in USDC on Base. Returns 8-K Item 2.02 press-release exhibit summaries for a company, newest filed first. List items omit text. Every item links to its SEC filing and exhibit. 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/earnings-releases?limit=1"
```

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

```bash
curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/earnings-releases?limit=1"
```

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

```json
{
  "x402Version": 2,
  "resource": {
    "url": "https://api.belfortagent.xyz/v1/companies/NVDA/earnings-releases?limit=1"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "18000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x80bEF165f2895539CfEcd74A7949A88e576e5E09",
      "maxTimeoutSeconds": 60
    }
  ]
}
```

## `GET /v1/companies/{id}/earnings-releases/{accession}`

**$0.03 per call** in USDC on Base. Returns one 8-K Item 2.02 press-release exhibit including its plain-text body. The response links to the SEC filing and exhibit. Charged only when at least one record comes back; errors and empty results are free.

An unpaid call answers `402 Payment Required`:

```bash
curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/earnings-releases/0001045810-26-000073"
```

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

```json
{
  "x402Version": 2,
  "resource": {
    "url": "https://api.belfortagent.xyz/v1/companies/NVDA/earnings-releases/0001045810-26-000073"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "30000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x80bEF165f2895539CfEcd74A7949A88e576e5E09",
      "maxTimeoutSeconds": 60
    }
  ]
}
```

## Details

- Every field, parameter and error: [Earnings releases](/datasets/earnings-releases/).
- 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/earnings-releases/
