Earnings releases API: pay per call with x402
Pay per call for earnings releases (8-K Item 2.02 exhibits) with x402: 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
Section titled “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):
curl "https://api.belfortagent.xyz/v1/companies/AAPL/earnings-releases?limit=1"Any other company answers 402 Payment Required until paid:
curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/earnings-releases?limit=1"The PAYMENT-REQUIRED header, base64-decoded (trimmed to the payment terms):
{ "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}
Section titled “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:
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):
{ "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
Section titled “Details”- Every field, parameter and error: Earnings releases.
- Machine-readable: the API’s OpenAPI document (
x-payment-infoon each paid route) and/.well-known/x402. - With an API key and card credits instead: Pricing.