Key metrics API: pay per call with x402
Pay per call for key metrics (revenue, net income, diluted EPS, operating cash flow, cash) 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}/metrics
Section titled “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):
curl "https://api.belfortagent.xyz/v1/companies/AAPL/metrics?metric=revenue&frequency=annual"Any other company answers 402 Payment Required until paid:
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):
{ "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
Section titled “Details”- Every field, parameter and error: Key metrics.
- 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.